Skip navigation links

Oracle® Spatial Java API Reference
11g Release 1 (11.1)

B28401-02


oracle.spatial.network.lod
Interface NetworkIO

All Known Subinterfaces:
CachedNetworkIO, CachedNetworkIOWM

public interface NetworkIO

This interface defines methods to read/write network information from/to a datasource.

Since:
11gR1

Method Summary
 void commit()
          Sends out commit command to the database.
 void deletePath(long pathId)
          Deletes path.
 void deletePaths(long[] pathIds)
          Deletes paths.
 void deleteSubPath(long subPathId)
          Deletes sub-path.
 void deleteSubPaths(long[] subPathIds)
          Deletes sub-paths.
 void generatePartitionBlob(int partitionId, int linkLevel, boolean includeUserData)
          Generate partition BLOB for the specified partition.
 void generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob)
          Generate partition BLOBs for the specified link level.
 java.lang.String getGlobalNetworkName()
          Returns the global network name, i.e., the network name that is globally unique, and that is used as the cache key for the network.
 NetworkMetadata getNetworkMetadata()
          Returns the network metadata.
 NetworkUpdate getNetworkUpdate(int linkLevel, long[] changedNodeIds, long[] changedLinkIds)
          Constructs network update object according to the changed node and link IDs.
 NetworkUpdate getNetworkUpdate(int linkLevel, long[] updatedNodeIds, long[] deletedNodeIds, long[] updatedLinkIds, long[] deletedLinkIds)
          Constructs network update object according to the changed node and link IDs.
 long getNextTmpLinkId()
          Returns the next temporary link ID.
 long getNextTmpNodeId()
          Returns the next temporary node ID.
 boolean[] isLinksExist(long[] linkIds)
          Checks whether the input links exist or not
 boolean[] isNodesExist(long[] nodeIds)
          Checks whether the input nodes exist or not
 java.util.Map<java.lang.Long,int[]> readAdjacentPartitionIdsForLinks(long[] linkIds, int linkLevel)
          Retrieves the relevant partition IDs for the specified node IDs.
 java.util.Map<java.lang.Long,int[]> readAdjacentPartitionIdsForNodes(long[] nodeIds, int linkLevel)
          Retrieves the adjacent partition IDs for the specified node IDs.
 int readComponentId(long nodeId, int linkLevel)
          Retrieves the component ID assigned to the specified node ID.
 int[] readComponentIds(int linkLevel)
          Retrieves the component IDs stored in the connected component table.
 LogicalHeavyPath readLogicalHeavyPath(LogicalPath path, boolean includeUserData)
          Retrieves node and link information for the specified logical path.
 LogicalHeavyPath[] readLogicalHeavyPaths(LogicalPath[] paths, boolean includeUserData)
          Retrieves node and link information for the specified logical paths.
 LogicalLink readLogicalLink(long linkId, boolean includeUserData)
          Retrieves the standalone logical link, i.e., the logical link without references to the start and end nodes, for the specified link ID.
 LogicalLink[] readLogicalLinks(long[] linkIds, boolean includeUserData)
          Retrieves the standalone logical link, i.e., the logical link without references to the start and end nodes, for the specified link ID.
 LogicalBasicNetwork readLogicalNetwork(int linkLevel, boolean includeUserData)
          Retrieves the logical network.
 LogicalBasicNetwork readLogicalNetwork(int linkLevel, boolean includeUserData, boolean readFromBlob)
          Retrieves the logical network.
 LogicalNode readLogicalNode(long nodeId, boolean includeUserData)
          Retrieves the standalone logical node, i.e., the logical node without references to incoming and outgoing links, for the specified node ID.
 LogicalNode[] readLogicalNodes(long[] nodeIds, boolean includeUserData)
          Retrieves the standalone logical nodes, i.e., the logical nodes without references to incoming and outgoing links, for the specified node IDs.
 LogicalPartition readLogicalPartition(int partitionId, int linkLevel, boolean includeUserData)
          Retrieves the logical network partition for the specified partition ID.
 LogicalPartition readLogicalPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob)
          Retrieves the logical network partition for the specified partition ID.
 LogicalPartition[] readLogicalPartitions(int linkLevel, boolean includeUserData)
          Retrieves all the logical network partitions in this network.
 LogicalPartition[] readLogicalPartitions(int linkLevel, boolean includeUserData, boolean readFromBlob)
          Retrieves all the logical network partitions.
 LogicalPath readLogicalPath(long pathId, boolean includeUserData)
          Retrieves the logical path for the specified path ID.
 LogicalPath[] readLogicalPaths(long[] pathIds, boolean includeUserData)
          Retrieves the logical paths for the specified path IDs.
 LogicalSubPath readLogicalSubPath(long subPathId, boolean includeUserData)
          Retrieves the logical subpath for the specified subpath ID.
 LogicalSubPath[] readLogicalSubPaths(long[] subPathIds, boolean includeUserData)
          Retrieves the logical subpaths for the specified subpath IDs.
 int readMaximumIncomingLinkLevel(long nodeId)
          Retrieves the maximum link level of the incoming links connected to the specified node.
 int readMaximumLinkLevel()
          Retrieves the maximum link level of the network.
 int readMaximumLinkLevel(long nodeId)
          Retrieves the maximum link level of the links connected to the specified node.
 int readMaximumOutgoingLinkLevel(long nodeId)
          Retrieves the maximum link level of the outgoing links connected to the specified node.
 long[] readNodeIds(int linkLevel)
          Retrieves the array of node IDs in the network.
 int readNumberOfConnectedComponents(int linkLevel)
          Retrieves the number of connected components stored in the component table.
 int readNumberOfLinkLevels()
          Retrieves the number of link levels.
 int readNumberOfLinks(int linkLevel)
          Retrieves the number of links in the network.
 int readNumberOfNodes(int linkLevel)
          Retrieves the number of nodes in the network.
 int readNumberOfPartitions(int linkLevel)
          Retrieves the number of partitions in the network.
 int readPartitionId(long nodeId, int linkLevel)
          Retrieves the partition ID for the specified node ID.
 int[] readPartitionIds(int linkLevel)
          Retrieves all the partition IDs in the network.
 int[] readPartitionIds(long[] nodeIds, int linkLevel)
          Retrieves the partition IDs for the specified node IDs.
 SpatialHeavyPath readSpatialHeavyPath(LogicalPath path, boolean includeUserData)
          Retrieves node and link information for the specified logical paths.
 SpatialHeavyPath[] readSpatialHeavyPaths(LogicalPath[] paths, boolean includeUserData)
          Retrieves node and link information for the specified logical paths.
 SpatialLink readSpatialLink(long linkId, boolean includeUserData)
          Retrieves the spatial link for the specified link ID.
 SpatialBasicNetwork readSpatialNetwork(LogicalBasicNetwork logicalNetwork)
          Retrieves spatial information for the logical network, and returns the spatial network.
 SpatialNode readSpatialNode(long nodeId, boolean includeUserData)
          Retrieves the spatial node for the specified node ID.
 SpatialPartition readSpatialPartition(LogicalPartition logicalPartition)
          Retrieves spatial information for the logical network partition, and returns the spatial network partition.
 JGeometry readSpatialPartitionMBR(int partitionId, int linkLevel)
          Returns the minimum bounding rectangle (MBR) encompassing all the nodes in the specified partition.
 java.util.Map<java.lang.Integer,JGeometry> readSpatialPartitionMBRs(int linkLevel)
          Returns the minimum bounding rectangles (MBR) of all the partitions in this network.
 SpatialPath readSpatialPath(LogicalPath logicalPath)
          Retrieves the spatial information for the specified logical path, and returns the spatial path.
 SpatialPath readSpatialPath(long pathId, boolean includeUserData)
          Retrieves the spatial path for the specified path ID.
 SpatialPath[] readSpatialPaths(LogicalPath[] logicalPath)
          Retrieves the spatial information for the specified logical path, and returns the spatial path.
 SpatialPath[] readSpatialPaths(long[] pathIds, boolean includeUserData)
          Retrieves the spatial path for the specified path ID.
 SpatialSubPath readSpatialSubPath(LogicalSubPath logicalSubPath)
          Retrieves the spatial information of the specified logical subpath, and returns the spatial subpath.
 SpatialSubPath readSpatialSubPath(long subPathId, boolean includeUserData)
          Retrieves the spatial subpath information.
 SpatialSubPath[] readSpatialSubPaths(LogicalSubPath[] logicalSubPaths)
          Retrieves the spatial information of the specified logical subpaths, and returns the spatial subpath.
 SpatialSubPath[] readSpatialSubPaths(long[] subPathIds, boolean includeUserData)
          Retrieves the spatial subpath information.
 void readUserData(LogicalPartition partition, LODUserDataIO udio)
          Add user data information to the logical partition
 void rollback()
          Sends out rollback command to the database.
 void saveConnectedComponents(OrderedLongSet[] components, int linkLevel)
          Stores the connected components information in the component table.
 void setNetworkAdaptor(oracle.spatial.network.lod.LODNetworkAdaptor adaptor)
          Sets the network adaptor.
 void setNetworkMetadata(NetworkMetadata metadata)
          Sets network metadata
 void writePath(LogicalPath path, long pathId, java.lang.String pathName, java.lang.String pathType)
          Stores a path in the database.
 long writePath(LogicalPath path, java.lang.String pathName, java.lang.String pathType)
          Stores a path in the database.
 void writeSubPath(LogicalSubPath subPath, long subPathId, long referencePathId, java.lang.String subPathName, java.lang.String subPathType)
          Stores a sub-path in the database.
 long writeSubPath(LogicalSubPath subPath, long referencePathId, java.lang.String subPathName, java.lang.String subPathType)
          Stores a sub-path in the database.

 

Method Detail

getGlobalNetworkName

java.lang.String getGlobalNetworkName()
Returns the global network name, i.e., the network name that is globally unique, and that is used as the cache key for the network.
Returns:
global network name

setNetworkAdaptor

void setNetworkAdaptor(oracle.spatial.network.lod.LODNetworkAdaptor adaptor)
Sets the network adaptor.
Parameters:
adaptor - network adaptor

getNetworkMetadata

NetworkMetadata getNetworkMetadata()
Returns the network metadata.
Returns:
network metadata

setNetworkMetadata

void setNetworkMetadata(NetworkMetadata metadata)
Sets network metadata
Parameters:
metadata - network metadata

commit

void commit()
            throws LODNetworkException
Sends out commit command to the database.
Throws:
LODNetworkException

rollback

void rollback()
              throws LODNetworkException
Sends out rollback command to the database.
Throws:
LODNetworkException

isNodesExist

boolean[] isNodesExist(long[] nodeIds)
                       throws LODNetworkException
Checks whether the input nodes exist or not
Parameters:
nodeIds - IDs of the nodes
Returns:
array of boolean indicating whether each of the input nodes exist or not.
Throws:
LODNetworkException

isLinksExist

boolean[] isLinksExist(long[] linkIds)
                       throws LODNetworkException
Checks whether the input links exist or not
Parameters:
linkIds - IDs of the links
Returns:
array of boolean indicating whether each of the input links exist or not.
Throws:
LODNetworkException

readNumberOfNodes

int readNumberOfNodes(int linkLevel)
                      throws LODNetworkException
Retrieves the number of nodes in the network.
Parameters:
linkLevel - link level
Returns:
the number of nodes in the network
Throws:
LODNetworkException

readNumberOfLinks

int readNumberOfLinks(int linkLevel)
                      throws LODNetworkException
Retrieves the number of links in the network.
Parameters:
linkLevel - link level
Returns:
the number of links in the network
Throws:
LODNetworkException

readNodeIds

long[] readNodeIds(int linkLevel)
                   throws LODNetworkException
Retrieves the array of node IDs in the network.
Parameters:
linkLevel - link level
Returns:
the array of node IDs in the network
Throws:
LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       boolean includeUserData,
                                       boolean readFromBlob)
                                       throws LODNetworkException
Retrieves the logical network.
Parameters:
linkLevel - link level
includeUserData - whether to include user data or not
readFromBlob - whether to read from BLOBs or from table
Returns:
the logical network
Throws:
LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       boolean includeUserData)
                                       throws LODNetworkException
Retrieves the logical network. Whether the network is loaded from BLOBs or from node and link tables depends on how it is configured in the LOD configuration xml.
Parameters:
linkLevel - link level
includeUserData - whether to include user data or not
Returns:
the logical network
Throws:
LODNetworkException

readLogicalPartition

LogicalPartition readLogicalPartition(int partitionId,
                                      int linkLevel,
                                      boolean includeUserData,
                                      boolean readFromBlob)
                                      throws LODNetworkException
Retrieves the logical network partition for the specified partition ID.
Parameters:
partitionId - partition ID
linkLevel - link level
includeUserData - whether to include user data or not
readFromBlob - whether to read from BLOBs or from table
Returns:
logical network partition
Throws:
LODNetworkException

readLogicalPartition

LogicalPartition readLogicalPartition(int partitionId,
                                      int linkLevel,
                                      boolean includeUserData)
                                      throws LODNetworkException
Retrieves the logical network partition for the specified partition ID. Whether the network partition is loaded from BLOBs or from node and link tables depends on how it is configured in the LOD configuration xml.
Parameters:
partitionId - partition ID
linkLevel - link level
includeUserData - whether to include user data or not
Returns:
logical network partition
Throws:
LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         boolean includeUserData,
                                         boolean readFromBlob)
                                         throws LODNetworkException
Retrieves all the logical network partitions.
Parameters:
linkLevel - link level
includeUserData - whether to include user data or not
readFromBlob - whether to read from BLOBs or from table
Returns:
logical network partition
Throws:
LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         boolean includeUserData)
                                         throws LODNetworkException
Retrieves all the logical network partitions in this network.
Parameters:
linkLevel - link level
includeUserData - whether to include user data or not
Returns:
all logical network partitions in this network
Throws:
LODNetworkException

readUserData

void readUserData(LogicalPartition partition,
                  LODUserDataIO udio)
                  throws LODNetworkException
Add user data information to the logical partition
Parameters:
partition - logical partition
udio - user data IO implementation
Throws:
LODNetworkException

readPartitionId

int readPartitionId(long nodeId,
                    int linkLevel)
                    throws LODNetworkException
Retrieves the partition ID for the specified node ID.
Parameters:
nodeId - node ID
linkLevel - link level
Returns:
partition ID
Throws:
LODNetworkException

readPartitionIds

int[] readPartitionIds(long[] nodeIds,
                       int linkLevel)
                       throws LODNetworkException
Retrieves the partition IDs for the specified node IDs.
Parameters:
nodeIds - node IDs
linkLevel - link level
Returns:
partition IDs
Throws:
LODNetworkException

readAdjacentPartitionIdsForNodes

java.util.Map<java.lang.Long,int[]> readAdjacentPartitionIdsForNodes(long[] nodeIds,
                                                                     int linkLevel)
                                                                     throws LODNetworkException
Retrieves the adjacent partition IDs for the specified node IDs. A partition is adjacent to a node if the node is either an internal or external node in this partition.
Parameters:
nodeIds - node IDs
linkLevel - link level
Returns:
relevant partition IDs for eath node ID.
Throws:
LODNetworkException

readAdjacentPartitionIdsForLinks

java.util.Map<java.lang.Long,int[]> readAdjacentPartitionIdsForLinks(long[] linkIds,
                                                                     int linkLevel)
                                                                     throws LODNetworkException
Retrieves the relevant partition IDs for the specified node IDs. A partition is adjacent to a link if the link is either an internal or boundary link in this partition.
Parameters:
linkIds - link IDs
linkLevel - link level
Returns:
relevant partition IDs for eath node ID.
Throws:
LODNetworkException

readPartitionIds

int[] readPartitionIds(int linkLevel)
                       throws LODNetworkException
Retrieves all the partition IDs in the network.
Parameters:
linkLevel - link level
Returns:
array of partition IDs
Throws:
LODNetworkException

readNumberOfPartitions

int readNumberOfPartitions(int linkLevel)
                           throws LODNetworkException
Retrieves the number of partitions in the network.
Parameters:
linkLevel - link level
Returns:
number of partitions
Throws:
LODNetworkException

readNumberOfConnectedComponents

int readNumberOfConnectedComponents(int linkLevel)
                                    throws LODNetworkException
Retrieves the number of connected components stored in the component table. This method should be called after the connected components habe been pre-computed and stored in the database.
Parameters:
linkLevel - link level
Returns:
number of connected components, if the connected components have been pre-computed and stored in the database;
-1, otherwise
Throws:
LODNetworkException

readComponentIds

int[] readComponentIds(int linkLevel)
                       throws LODNetworkException
Retrieves the component IDs stored in the connected component table. This method should be called after the connected components habe been pre-computed and stored in the database.
Parameters:
linkLevel - link level
Returns:
the component ID array, if the connected components have been pre-computed and stored in the database;
null, otherwise
Throws:
LODNetworkException

readComponentId

int readComponentId(long nodeId,
                    int linkLevel)
                    throws LODNetworkException
Retrieves the component ID assigned to the specified node ID. This method should be called after the connected components habe been pre-computed and stored in the database.
Parameters:
nodeId - node ID
linkLevel - link level
Returns:
the component ID assigned to the specified node ID, if the connected components have been pre-computed and stored in the database;
-1, otherwise
Throws:
LODNetworkException

readLogicalLink

LogicalLink readLogicalLink(long linkId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the standalone logical link, i.e., the logical link without references to the start and end nodes, for the specified link ID.
Parameters:
linkId - link ID
includeUserData - whether to include the userdata or not
Returns:
logical link
Throws:
LODNetworkException

readLogicalLinks

LogicalLink[] readLogicalLinks(long[] linkIds,
                               boolean includeUserData)
                               throws LODNetworkException
Retrieves the standalone logical link, i.e., the logical link without references to the start and end nodes, for the specified link ID.
Parameters:
linkIds - link ID
includeUserData - whether to include the userdata or not
Returns:
logical link
Throws:
LODNetworkException

readLogicalNode

LogicalNode readLogicalNode(long nodeId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the standalone logical node, i.e., the logical node without references to incoming and outgoing links, for the specified node ID.
Parameters:
nodeId - node ID
includeUserData - whether to include the userdata or not
Returns:
logical node
Throws:
LODNetworkException

readLogicalNodes

LogicalNode[] readLogicalNodes(long[] nodeIds,
                               boolean includeUserData)
                               throws LODNetworkException
Retrieves the standalone logical nodes, i.e., the logical nodes without references to incoming and outgoing links, for the specified node IDs.
Parameters:
nodeIds - node IDs
includeUserData - whether to include the userdata or not
Returns:
logical node
Throws:
LODNetworkException

readLogicalPath

LogicalPath readLogicalPath(long pathId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the logical path for the specified path ID.
Parameters:
pathId - path ID
includeUserData - whether to include the userdata or not
Returns:
logical path
Throws:
LODNetworkException

readLogicalPaths

LogicalPath[] readLogicalPaths(long[] pathIds,
                               boolean includeUserData)
                               throws LODNetworkException
Retrieves the logical paths for the specified path IDs.
Parameters:
pathIds - path IDs
includeUserData - whether to include the userdata or not
Returns:
logical paths
Throws:
LODNetworkException

readLogicalSubPath

LogicalSubPath readLogicalSubPath(long subPathId,
                                  boolean includeUserData)
                                  throws LODNetworkException
Retrieves the logical subpath for the specified subpath ID.
Parameters:
subPathId - subpath ID
includeUserData - whether to include the userdata or not
Returns:
logical subpath
Throws:
LODNetworkException

readLogicalSubPaths

LogicalSubPath[] readLogicalSubPaths(long[] subPathIds,
                                     boolean includeUserData)
                                     throws LODNetworkException
Retrieves the logical subpaths for the specified subpath IDs.
Parameters:
subPathIds - subpath IDs
includeUserData - whether to include the userdata or not
Returns:
logical subpaths
Throws:
LODNetworkException

readLogicalHeavyPath

LogicalHeavyPath readLogicalHeavyPath(LogicalPath path,
                                      boolean includeUserData)
                                      throws LODNetworkException
Retrieves node and link information for the specified logical path.
Parameters:
path - logical path without detailed node and link information
includeUserData - whether to include user data or not
Returns:
Throws:
LODNetworkException

readLogicalHeavyPaths

LogicalHeavyPath[] readLogicalHeavyPaths(LogicalPath[] paths,
                                         boolean includeUserData)
                                         throws LODNetworkException
Retrieves node and link information for the specified logical paths.
Parameters:
paths - logical paths without detailed node and link information
includeUserData - whether to include user data or not
Returns:
heavy logical paths, i.e., logical paths with detailed node and link information
Throws:
LODNetworkException

readSpatialNetwork

SpatialBasicNetwork readSpatialNetwork(LogicalBasicNetwork logicalNetwork)
                                       throws LODNetworkException
Retrieves spatial information for the logical network, and returns the spatial network.
Parameters:
logicalNetwork - logical network
Returns:
spatial network
Throws:
LODNetworkException

readSpatialPartition

SpatialPartition readSpatialPartition(LogicalPartition logicalPartition)
                                      throws LODNetworkException
Retrieves spatial information for the logical network partition, and returns the spatial network partition.
Parameters:
logicalPartition - logical network partition
Returns:
spatial network partition
Throws:
LODNetworkException

readSpatialPartitionMBR

JGeometry readSpatialPartitionMBR(int partitionId,
                                  int linkLevel)
                                  throws LODNetworkException
Returns the minimum bounding rectangle (MBR) encompassing all the nodes in the specified partition. Note that link geometries in the partition might cross the boundaries of the returned MBR.
Parameters:
partitionId - partition ID
linkLevel - link level
Returns:
a polygon type JGeometry instance representing the MBR
Throws:
LODNetworkException

readSpatialPartitionMBRs

java.util.Map<java.lang.Integer,JGeometry> readSpatialPartitionMBRs(int linkLevel)
                                                                    throws LODNetworkException
Returns the minimum bounding rectangles (MBR) of all the partitions in this network.
Parameters:
linkLevel - link level
Returns:
a map, whose keys are the partition IDs in the network, and whose values are polygon type JGeometry instances representing the MBRs of the corresponding partitions.
Throws:
LODNetworkException

readSpatialPath

SpatialPath readSpatialPath(long pathId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the spatial path for the specified path ID.
Parameters:
pathId - path ID
includeUserData - whether to include the userdata or not
Returns:
spatial path
Throws:
LODNetworkException

readSpatialPaths

SpatialPath[] readSpatialPaths(long[] pathIds,
                               boolean includeUserData)
                               throws LODNetworkException
Retrieves the spatial path for the specified path ID.
Parameters:
pathIds - path ID
includeUserData - whether to include the userdata or not
Returns:
spatial path
Throws:
LODNetworkException

readSpatialPath

SpatialPath readSpatialPath(LogicalPath logicalPath)
                            throws LODNetworkException
Retrieves the spatial information for the specified logical path, and returns the spatial path.
Parameters:
logicalPath - logical path
Returns:
spatial path
Throws:
LODNetworkException

readSpatialPaths

SpatialPath[] readSpatialPaths(LogicalPath[] logicalPath)
                               throws LODNetworkException
Retrieves the spatial information for the specified logical path, and returns the spatial path.
Parameters:
logicalPath - logical path
Returns:
spatial path
Throws:
LODNetworkException

readSpatialSubPath

SpatialSubPath readSpatialSubPath(long subPathId,
                                  boolean includeUserData)
                                  throws LODNetworkException
Retrieves the spatial subpath information.
Parameters:
subPathId - subpath ID
includeUserData - whether to include the userdata or not
Returns:
spatial subpath
Throws:
LODNetworkException

readSpatialSubPaths

SpatialSubPath[] readSpatialSubPaths(long[] subPathIds,
                                     boolean includeUserData)
                                     throws LODNetworkException
Retrieves the spatial subpath information.
Parameters:
subPathIds - subpath IDs
includeUserData - whether to include the userdata or not
Returns:
spatial subpath
Throws:
LODNetworkException

readSpatialSubPath

SpatialSubPath readSpatialSubPath(LogicalSubPath logicalSubPath)
                                  throws LODNetworkException
Retrieves the spatial information of the specified logical subpath, and returns the spatial subpath.
Parameters:
logicalSubPath - logical subpath
Returns:
spatial subpath
Throws:
LODNetworkException

readSpatialSubPaths

SpatialSubPath[] readSpatialSubPaths(LogicalSubPath[] logicalSubPaths)
                                     throws LODNetworkException
Retrieves the spatial information of the specified logical subpaths, and returns the spatial subpath.
Parameters:
logicalSubPaths - logical subpath
Returns:
spatial subpaths
Throws:
LODNetworkException

readSpatialHeavyPath

SpatialHeavyPath readSpatialHeavyPath(LogicalPath path,
                                      boolean includeUserData)
                                      throws LODNetworkException
Retrieves node and link information for the specified logical paths.
Parameters:
path - logical path without detailed node and link information
includeUserData - whether to include user data or not
Returns:
heavy logical path, i.e., logical path with detailed node and link information
Throws:
LODNetworkException

readSpatialHeavyPaths

SpatialHeavyPath[] readSpatialHeavyPaths(LogicalPath[] paths,
                                         boolean includeUserData)
                                         throws LODNetworkException
Retrieves node and link information for the specified logical paths.
Parameters:
paths - logical paths without detailed node and link information
includeUserData - whether to include user data or not
Returns:
heavy logical paths, i.e., logical paths with detailed node and link information
Throws:
LODNetworkException

readSpatialLink

SpatialLink readSpatialLink(long linkId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the spatial link for the specified link ID.
Parameters:
linkId - link ID
Returns:
spatial link
Throws:
LODNetworkException

readSpatialNode

SpatialNode readSpatialNode(long nodeId,
                            boolean includeUserData)
                            throws LODNetworkException
Retrieves the spatial node for the specified node ID.
Parameters:
nodeId - node ID
Returns:
spatial node
Throws:
LODNetworkException

readNumberOfLinkLevels

int readNumberOfLinkLevels()
                           throws LODNetworkException
Retrieves the number of link levels.
Returns:
number of link levels
Throws:
LODNetworkException

readMaximumLinkLevel

int readMaximumLinkLevel()
                         throws LODNetworkException
Retrieves the maximum link level of the network.
Returns:
maximum link level of the network
Throws:
LODNetworkException

readMaximumLinkLevel

int readMaximumLinkLevel(long nodeId)
                         throws LODNetworkException
Retrieves the maximum link level of the links connected to the specified node.
Parameters:
nodeId - node ID
Returns:
maximum link level
Throws:
LODNetworkException

readMaximumIncomingLinkLevel

int readMaximumIncomingLinkLevel(long nodeId)
                                 throws LODNetworkException
Retrieves the maximum link level of the incoming links connected to the specified node.
Parameters:
nodeId - node ID
Returns:
maximum incoming link level
Throws:
LODNetworkException

readMaximumOutgoingLinkLevel

int readMaximumOutgoingLinkLevel(long nodeId)
                                 throws LODNetworkException
Retrieves the maximum link level of the outgoing links connected to the specified node.
Parameters:
nodeId - node ID
Returns:
maximum outgoing link level
Throws:
LODNetworkException

getNetworkUpdate

NetworkUpdate getNetworkUpdate(int linkLevel,
                               long[] updatedNodeIds,
                               long[] deletedNodeIds,
                               long[] updatedLinkIds,
                               long[] deletedLinkIds)
                               throws LODNetworkException
Constructs network update object according to the changed node and link IDs.
Parameters:
linkLevel - link level
updatedNodeIds - new and updated node IDs
deletedNodeIds - deleted node IDs
updatedLinkIds - new and updated link IDs
deletedLinkIds - deleted link IDs
Returns:
network update object
Throws:
LODNetworkException

getNetworkUpdate

NetworkUpdate getNetworkUpdate(int linkLevel,
                               long[] changedNodeIds,
                               long[] changedLinkIds)
                               throws LODNetworkException
Constructs network update object according to the changed node and link IDs.
Parameters:
linkLevel - link level
changedNodeIds - new, updated and deleted node IDs
changedLinkIds - new, updated and deleted link IDs
Returns:
network update object
Throws:
LODNetworkException

writePath

long writePath(LogicalPath path,
               java.lang.String pathName,
               java.lang.String pathType)
               throws LODNetworkException
Stores a path in the database.
Parameters:
path - path
pathName - user specified path name
pathType - user specified path type
Returns:
path ID
Throws:
LODNetworkException

writePath

void writePath(LogicalPath path,
               long pathId,
               java.lang.String pathName,
               java.lang.String pathType)
               throws LODNetworkException
Stores a path in the database.
Parameters:
path - path
pathId - path ID
pathName - user specified path name
pathType - user specified path type
Throws:
LODNetworkException

writeSubPath

long writeSubPath(LogicalSubPath subPath,
                  long referencePathId,
                  java.lang.String subPathName,
                  java.lang.String subPathType)
                  throws LODNetworkException
Stores a sub-path in the database. Before calling this method, the reference path must have already been stored in the database.
Parameters:
subPath - sub-path
referencePathId - reference path ID
subPathName - user specified sub-path name
subPathType - user specified sub-path type
Returns:
sub-path ID
Throws:
LODNetworkException

writeSubPath

void writeSubPath(LogicalSubPath subPath,
                  long subPathId,
                  long referencePathId,
                  java.lang.String subPathName,
                  java.lang.String subPathType)
                  throws LODNetworkException
Stores a sub-path in the database. Before calling this method, the reference path must have already been stored in the database.
Parameters:
subPath - sub-path
subPathId - sub-path ID
referencePathId - reference path ID
subPathName - user specified sub-path name
subPathType - user specified sub-path type
Throws:
LODNetworkException

deletePath

void deletePath(long pathId)
                throws LODNetworkException
Deletes path.
Parameters:
pathId - path ID
Throws:
LODNetworkException

deletePaths

void deletePaths(long[] pathIds)
                 throws LODNetworkException
Deletes paths.
Parameters:
pathIds - path IDs
Throws:
LODNetworkException

deleteSubPath

void deleteSubPath(long subPathId)
                   throws LODNetworkException
Deletes sub-path.
Parameters:
subPathId - sub-path ID
Throws:
LODNetworkException

deleteSubPaths

void deleteSubPaths(long[] subPathIds)
                    throws LODNetworkException
Deletes sub-paths.
Parameters:
subPathIds - sub-path IDs
Throws:
LODNetworkException

saveConnectedComponents

void saveConnectedComponents(OrderedLongSet[] components,
                             int linkLevel)
                             throws LODNetworkException
Stores the connected components information in the component table.
Parameters:
components - array of connected components. Each connected component is represented by a set of node IDs.
linkLevel - link level
Throws:
LODNetworkException

generatePartitionBlobs

void generatePartitionBlobs(int linkLevel,
                            boolean includeUserData,
                            boolean commitForEachBlob)
                            throws LODNetworkException
Generate partition BLOBs for the specified link level.
Parameters:
linkLevel - link level
includeUserData - whether to include user data or not
Throws:
LODNetworkException

generatePartitionBlob

void generatePartitionBlob(int partitionId,
                           int linkLevel,
                           boolean includeUserData)
                           throws LODNetworkException
Generate partition BLOB for the specified partition.
Parameters:
partitionId - partition ID
linkLevel - link level
includeUserData - whether to include user data or not
Throws:
LODNetworkException

getNextTmpNodeId

long getNextTmpNodeId()
Returns the next temporary node ID.
Returns:

getNextTmpLinkId

long getNextTmpLinkId()
Returns the next temporary link ID.
Returns:

Skip navigation links

Oracle® Spatial Java API Reference
11g Release 1 (11.1)

B28401-02


Copyright © 2007, 2008, Oracle. All Rights Reserved.