Package oracle.spatial.network.lod
Interface NetworkIO
-
- All Known Subinterfaces:
CachedNetworkIO,CachedNetworkIOWM
public interface NetworkIOThis interface defines methods to read/write network information from/to a datasource.- Since:
- 11gR1
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description voidclose()voidcommit()Sends out commit command to the database.JGeometry[]computeFeatureGeometries(Feature[] features, int nodeGeomUserDataCategory, int nodeGeomUserDataIndex, int linkGeomUserDataCategory, int linkGeomUserDataIndex, boolean consolidate)Constructs the feature geometry from the geometries of its network elements.voiddeleteNetworkBuffer(long id)Deletes the network buffer from the database.voiddeleteNetworkBuffer(long id, java.lang.String bufferName)Deletes the network buffer from the database.voiddeletePath(long pathId)Deletes path.voiddeletePaths(long[] pathIds)Deletes paths.voiddeleteSubPath(long subPathId)Deletes sub-path.voiddeleteSubPaths(long[] subPathIds)Deletes sub-paths.voidgeneratePartitionBlob(int partitionId, int linkLevel, boolean includeUserData)Generate partition BLOB for the specified partition.voidgeneratePartitionBlob(int partitionId, int linkLevel, boolean includeUserData, boolean performDeltaUpdate)Generates partition BLOB for the specified partition.voidgeneratePartitionBlobs(boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)Generates partition BLOBs for all link levels.voidgeneratePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob)Generates partition BLOBs for the specified link level.voidgeneratePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)Generates partition BLOBs for the specified link level.java.sql.ConnectiongetConnection()Deprecated.use getDataSource insteadoracle.spatial.network.ds.IDataSourcegetDataSource()Returns the data source.java.lang.StringgetGlobalNetworkName()Returns the global network name, i.e., the network name that is globally unique, and is used as the cache key for the network.NetworkIOConfiggetNetworkIOConfig()Returns the network IO configuration.NetworkMetadatagetNetworkMetadata()Returns the network metadata.java.lang.StringgetNetworkName()Returns the network name used in network metadata.longgetNextId()Returns the next value from the NDM ID sequence.longgetNextTmpLinkId()Returns the next temporary link ID.longgetNextTmpNodeId()Returns the next temporary node ID.PartitionBlobTranslatorgetPartitionBlobTranslator()Returns the partition blob translator implementation.LODUserDataIO[]getUserDataIOs()Returns the user data IO implementations.boolean[]hasLinks(long[] linkIds)Checks whether the input links exist or notboolean[]hasNodes(long[] nodeIds)Checks whether the input nodes exist or notboolean[]isLinksExist(long[] linkIds)Checks whether the input links exist or notboolean[]isNodesExist(long[] nodeIds)Checks whether the input nodes exist or notbooleanisReadFromBlob()Returns true if the partitions are read from BLOB; false if the partitions are read from node/link tables.voidopen()LongHashMap<int[]>readAdjacentPartitionIdsForLinks(long[] linkIds, int linkLevel)Retrieves the relevant partition IDs for the specified node IDs.LongHashMap<int[]>readAdjacentPartitionIdsForNodes(long[] nodeIds, int linkLevel)Retrieves the adjacent partition IDs for the specified node IDs.LogicalLinkreadArbitraryLogicalLink(int linkLevel, int[] userDataCategories)Returns an arbitrary link from the specified link level.LogicalLink[]readArbitraryLogicalLinks(int linkLevel, int numberOfLinks, int[] userDataCategories)Returns an array of arbitrary links from the specified link level.LogicalNodereadArbitraryLogicalNode(int linkLevel, int[] userDataCategories)Returns an arbitrary node from the specified link level.LogicalNode[]readArbitraryLogicalNodes(int linkLevel, int numberOfNodes, int[] userDataCategories)Returns an array of arbitrary nodes from the specified link level.intreadComponentId(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.voidreadFeatureData(LogicalPartition partition, int[] featureLayerIds, int[] userDataCategories)Adds feature data to the logical partitionFeature[]readFeatures(int featureLayerId, long[] featureIds, int[] userDataCategories)Read features.long[]readLinkIds(int linkLevel)int[]readLinkPartitionIds(long[] linkIds, int linkLevel)Retrieves the partition IDs for the specified links.int[]readLinkPartitionIds(long linkId, int linkLevel)Retrieves the partition IDs for the specified link.LogicalHeavyPathreadLogicalHeavyPath(LogicalPath path, boolean includeUserData)Retrieves node and link information for the specified logical path.LogicalHeavyPathreadLogicalHeavyPath(LogicalPath path, int[] userDataCategories)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.LogicalHeavyPath[]readLogicalHeavyPaths(LogicalPath[] paths, int[] userDataCategories)Retrieves node and link information for the specified logical paths.LogicalLinkreadLogicalLink(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.LogicalLinkreadLogicalLink(long linkId, int[] userDataCategories)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(int linkLevel, int[] userDataCategories)Returns the links on the specified link level.LogicalLink[]readLogicalLinks(long[] linkIds, boolean includeUserData)Retrieves the standalone logical links, i.e., the logical link without references to the start and end nodes, for the specified link ID.LogicalLink[]readLogicalLinks(long[] linkIds, int[] userDataCategories)Retrieves the standalone logical links, i.e., the logical link without references to the start and end nodes, for the specified link ID.LogicalBasicNetworkreadLogicalNetwork(int linkLevel, boolean includeUserData)Retrieves the logical network.LogicalBasicNetworkreadLogicalNetwork(int linkLevel, boolean includeUserData, boolean readFromBlob)Retrieves the logical network.LogicalBasicNetworkreadLogicalNetwork(int linkLevel, int[] userDataCategories)Retrieves the logical network.LogicalBasicNetworkreadLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds)Retrieves the logical network.LogicalBasicNetworkreadLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob)Retrieves the logical network.LogicalNodereadLogicalNode(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.LogicalNodereadLogicalNode(long nodeId, int[] userDataCategories)Retrieves the standalone logical node, i.e., the logical node without references to incoming and outgoing links, for the specified node ID.LogicalNode[]readLogicalNodes(int linkLevel, int[] userDataCategories)Returns the nodes on the specified link level.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.LogicalNode[]readLogicalNodes(long[] nodeIds, int[] userDataCategories)Retrieves the standalone logical nodes, i.e., the logical nodes without references to incoming and outgoing links, for the specified node IDs.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, boolean includeUserData)Retrieves the logical network partition for the specified partition ID.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob)Retrieves the logical network partition for the specified partition ID.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories)Retrieves the logical network partition for the specified partition ID.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, boolean readFromBlob)Retrieves the logical network partition for the specified partition ID.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds)Retrieves the logical network partition for the specified partition ID.LogicalPartitionreadLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds, 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.LogicalPartition[]readLogicalPartitions(int linkLevel, int[] userDataCategories)Retrieves all the logical network partitions in this network.LogicalPartition[]readLogicalPartitions(int linkLevel, int[] userDataCategories, boolean readFromBlob)Retrieves all the logical network partitions.LogicalPartition[]readLogicalPartitions(int linkLevel, int[] userDataCategories, int[] featureLayerIds)Retrieves all the logical network partitions in this network.LogicalPartition[]readLogicalPartitions(int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob)Retrieves all the logical network partitions.LogicalPathreadLogicalPath(long pathId, boolean includeUserData)Retrieves the logical path for the specified path ID.LogicalPathreadLogicalPath(long pathId, int[] userDataCategories)Retrieves the logical path for the specified path ID.LogicalPath[]readLogicalPaths(long[] pathIds, boolean includeUserData)Retrieves the logical paths for the specified path IDs.LogicalPath[]readLogicalPaths(long[] pathIds, int[] userDataCategories)Retrieves the logical paths for the specified path IDs.LogicalSubPathreadLogicalSubPath(long subPathId, boolean includeUserData)Retrieves the logical subpath for the specified subpath ID.LogicalSubPathreadLogicalSubPath(long subPathId, int[] userDataCategories)Retrieves the logical subpath for the specified subpath ID.LogicalSubPath[]readLogicalSubPaths(long[] subPathIds, boolean includeUserData)Retrieves the logical subpaths for the specified subpath IDs.LogicalSubPath[]readLogicalSubPaths(long[] subPathIds, int[] userDataCategories)Retrieves the logical subpaths for the specified subpath IDs.intreadMaximumIncomingLinkLevel(long nodeId)Retrieves the maximum link level of the incoming links connected to the specified node.intreadMaximumLinkLevel()Retrieves the maximum link level of the network.intreadMaximumLinkLevel(long nodeId)Retrieves the maximum link level of the links connected to the specified node.intreadMaximumOutgoingLinkLevel(long nodeId)Retrieves the maximum link level of the outgoing links connected to the specified node.NetworkBufferreadNetworkBuffer(long bufferId)Reads the network buffer with the specified buffer ID.NetworkBufferreadNetworkBuffer(long bufferId, java.lang.String bufferName)Reads the network buffer with the specified buffer ID.NetworkUpdatereadNetworkUpdate(int linkLevel, long[] changedNodeIds, long[] changedLinkIds, int[] userDataCategories)Constructs network update object according to the changed node and link IDs.NetworkUpdatereadNetworkUpdate(int linkLevel, long[] updatedNodeIds, long[] deletedNodeIds, long[] updatedLinkIds, long[] deletedLinkIds, int[] userDataCategories)Constructs network update object according to the changed node and link IDs.NetworkUpdatereadNetworkUpdate(int linkLevel, java.util.Calendar lastUpdateTime, int[] userDataCategories)NetworkUpdate[]readNetworkUpdates(java.util.Calendar lastUpdateTime, int[] userDataCategories)long[]readNodeIds(int linkLevel)Retrieves the array of node IDs in the network.intreadNodePartitionId(long nodeId, int linkLevel)Retrieves the partition ID for the specified node ID.int[]readNodePartitionIds(long[] nodeIds, int linkLevel)Retrieves the partition IDs for the specified node IDs.intreadNumberOfConnectedComponents(int linkLevel)Retrieves the number of connected components stored in the component table.intreadNumberOfLinkLevels()Retrieves the number of link levels.intreadNumberOfLinks(int linkLevel)Retrieves the number of links in the network.intreadNumberOfNodes(int linkLevel)Retrieves the number of nodes in the network.intreadNumberOfPartitions(int linkLevel)Retrieves the number of partitions in the network.intreadPartitionId(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.SpatialHeavyPathreadSpatialHeavyPath(LogicalPath path, boolean includeUserData)Retrieves node and link information for the specified logical paths.SpatialHeavyPathreadSpatialHeavyPath(LogicalPath path, int[] userDataCategories)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.SpatialHeavyPath[]readSpatialHeavyPaths(LogicalPath[] paths, int[] userDataCategories)Retrieves node and link information for the specified logical paths.SpatialLinkreadSpatialLink(long linkId, boolean includeUserData)Retrieves the spatial link for the specified link ID.SpatialLinkreadSpatialLink(long linkId, int[] userDataCategories)Retrieves the spatial link for the specified link ID.SpatialLink[]readSpatialLinks(long[] linkIds, boolean includeUserData)Retrieves the spatial links for the specified link IDs.SpatialLink[]readSpatialLinks(long[] linkIds, int[] userDataCategories)Retrieves the spatial links for the specified link IDs.SpatialBasicNetworkreadSpatialNetwork(LogicalBasicNetwork logicalNetwork)Retrieves spatial information for the logical network, and returns the spatial network.SpatialNodereadSpatialNode(long nodeId, boolean includeUserData)Retrieves the spatial node for the specified node ID.SpatialNodereadSpatialNode(long nodeId, int[] userDataCategories)Retrieves the spatial node for the specified node ID.SpatialNode[]readSpatialNodes(long[] nodeIds, boolean includeUserData)Retrieves the spatial nodes for the specified node IDs.SpatialNode[]readSpatialNodes(long[] nodeIds, int[] userDataCategories)Retrieves the spatial nodes for the specified node IDs.SpatialPartitionreadSpatialPartition(int partitionId, int linkLevel, boolean includeUserData)Retrieves spatial partition.SpatialPartitionreadSpatialPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob)Retrieves spatial partition.SpatialPartitionreadSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds)Retrieves spatial partition.SpatialPartitionreadSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob)Retrieves spatial partition.SpatialPartitionreadSpatialPartition(LogicalPartition logicalPartition)Retrieves spatial information for the logical network partition, and returns the spatial network partition.JGeometryreadSpatialPartitionMBR(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.SpatialPathreadSpatialPath(long pathId, boolean includeUserData)Retrieves the spatial path for the specified path ID.SpatialPathreadSpatialPath(long pathId, int[] userDataCategories)Retrieves the spatial path for the specified path ID.SpatialPathreadSpatialPath(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.SpatialPath[]readSpatialPaths(long[] pathIds, int[] userDataCategories)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.SpatialSubPathreadSpatialSubPath(long subPathId, boolean includeUserData)Retrieves the spatial subpath information.SpatialSubPathreadSpatialSubPath(long subPathId, int[] userDataCategories)Retrieves the spatial subpath information.SpatialSubPathreadSpatialSubPath(LogicalSubPath logicalSubPath)Retrieves the spatial information of the specified logical subpath, and returns the spatial subpath.SpatialSubPath[]readSpatialSubPaths(long[] subPathIds, boolean includeUserData)Retrieves the spatial subpath information.SpatialSubPath[]readSpatialSubPaths(long[] subPathIds, int[] userDataCategories)Retrieves the spatial subpath information.SpatialSubPath[]readSpatialSubPaths(LogicalSubPath[] logicalSubPaths)Retrieves the spatial information of the specified logical subpaths, and returns the spatial subpath.voidreadUserData(LogicalPartition partition, int[] userDataCategories)Adds user data information to the logical partitionvoidrollback()Sends out rollback command to the database.voidsaveConnectedComponents(OrderedLongSet[] components, int linkLevel)Stores the connected components information in the component table.voidsetConnection(java.sql.Connection conn)Deprecated.use setDataSource insteadvoidsetDataSource(oracle.spatial.network.ds.IDataSource dataSource)Sets the data source.voidsetGlobalNetworkName(java.lang.String globalNetworkName)Sets the global network name, i.e., the network name that is globally unique, and is used as the cache key for the network.voidsetNetworkMetadata(NetworkMetadata metadata)Sets network metadatavoidsetPartitionBlobTranslator(PartitionBlobTranslator translator)Sets the partition blob translator.voidsetReadFromBlob(boolean readFromBlob)Sets whether to read partitions from BLOBs.voidsetUserDataIOs(LODUserDataIO[] udios)Sets the user data IO implementations.voidupdatePartitionBlobInfo(int partitionId, int linkLevel, int numberOfInternalNodes, int numberOfExternalNodes, int numberOfInternalLinks, int numberOfBoundaryLinks, int numberOfIncomingLinks, int numberOfOutgoingLinks, boolean isUserDataIncluded)Updates the partition BLOB info in the partition BLOB table.longwriteNetworkBuffer(NetworkBuffer buffer)Stores the network buffer into the database.voidwriteNetworkBuffer(NetworkBuffer networkBuffer, long bufferId)Stores the network buffer into the database.voidwriteNetworkBuffer(NetworkBuffer networkBuffer, long bufferId, java.lang.String bufferName)Stores the network buffer into the database.longwriteNetworkBuffer(NetworkBuffer buffer, java.lang.String bufferName)Stores the network buffer into the database.voidwritePath(LogicalPath path, long pathId, java.lang.String pathName, java.lang.String pathType)Stores a path in the database.longwritePath(LogicalPath path, java.lang.String pathName, java.lang.String pathType)Stores a path in the database.voidwriteSubPath(LogicalSubPath subPath, long subPathId, long referencePathId, java.lang.String subPathName, java.lang.String subPathType)Stores a sub-path in the database.longwriteSubPath(LogicalSubPath subPath, long referencePathId, java.lang.String subPathName, java.lang.String subPathType)Stores a sub-path in the database.
-
-
-
Method Detail
-
close
void close() throws LODNetworkException- Throws:
LODNetworkException
-
open
void open() throws LODNetworkException
- Throws:
LODNetworkException
-
getConnection
java.sql.Connection getConnection()
Deprecated.use getDataSource insteadReturns the cached database connection managed by the user.- Returns:
-
setConnection
void setConnection(java.sql.Connection conn)
Deprecated.use setDataSource insteadSets the cached database connection managed by the user.- Parameters:
conn-
-
getDataSource
oracle.spatial.network.ds.IDataSource getDataSource()
Returns the data source.- Returns:
-
setDataSource
void setDataSource(oracle.spatial.network.ds.IDataSource dataSource)
Sets the data source.- Parameters:
dataSource-
-
getGlobalNetworkName
java.lang.String getGlobalNetworkName()
Returns the global network name, i.e., the network name that is globally unique, and is used as the cache key for the network.- Returns:
- global network name
-
setGlobalNetworkName
void setGlobalNetworkName(java.lang.String globalNetworkName)
Sets the global network name, i.e., the network name that is globally unique, and is used as the cache key for the network.- Parameters:
globalNetworkName- global network name
-
getNetworkName
java.lang.String getNetworkName()
Returns the network name used in network metadata.- Returns:
- global network name
-
getNetworkMetadata
NetworkMetadata getNetworkMetadata()
Returns the network metadata.- Returns:
- network metadata
-
getNetworkIOConfig
NetworkIOConfig getNetworkIOConfig()
Returns the network IO configuration.- Returns:
-
setNetworkMetadata
void setNetworkMetadata(NetworkMetadata metadata)
Sets network metadata- Parameters:
metadata- network metadata
-
getUserDataIOs
LODUserDataIO[] getUserDataIOs()
Returns the user data IO implementations.- Returns:
- user data IO implementations
-
setUserDataIOs
void setUserDataIOs(LODUserDataIO[] udios)
Sets the user data IO implementations.- Parameters:
udios-
-
isReadFromBlob
boolean isReadFromBlob()
Returns true if the partitions are read from BLOB; false if the partitions are read from node/link tables.
-
setReadFromBlob
void setReadFromBlob(boolean readFromBlob)
Sets whether to read partitions from BLOBs.- Parameters:
readFromBlob- true if the partitions are read from BLOBs; false if the partitions are read from node/link tables.
-
getPartitionBlobTranslator
PartitionBlobTranslator getPartitionBlobTranslator()
Returns the partition blob translator implementation.
-
setPartitionBlobTranslator
void setPartitionBlobTranslator(PartitionBlobTranslator translator)
Sets the partition blob translator.- Parameters:
translator-
-
commit
void commit() throws LODNetworkExceptionSends out commit command to the database.- Throws:
LODNetworkException
-
rollback
void rollback() throws LODNetworkExceptionSends out rollback command to the database.- Throws:
LODNetworkException
-
getNextId
long getNextId() throws LODNetworkExceptionReturns the next value from the NDM ID sequence.- Returns:
- Throws:
LODNetworkException
-
isNodesExist
boolean[] isNodesExist(long[] nodeIds) throws LODNetworkExceptionChecks 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
-
hasNodes
boolean[] hasNodes(long[] nodeIds) throws LODNetworkExceptionChecks 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 LODNetworkExceptionChecks 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
-
hasLinks
boolean[] hasLinks(long[] linkIds) throws LODNetworkExceptionChecks 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
-
updatePartitionBlobInfo
void updatePartitionBlobInfo(int partitionId, int linkLevel, int numberOfInternalNodes, int numberOfExternalNodes, int numberOfInternalLinks, int numberOfBoundaryLinks, int numberOfIncomingLinks, int numberOfOutgoingLinks, boolean isUserDataIncluded) throws LODNetworkExceptionUpdates the partition BLOB info in the partition BLOB table.- Parameters:
partitionId- partition IDlinkLevel- link levelnumberOfInternalNodes- number of internal nodesnumberOfExternalNodes- number of external nodesnumberOfInternalLinks- number of internal linksnumberOfBoundaryLinks- number of boundary linksnumberOfIncomingLinks- number of incoming linksnumberOfOutgoingLinks- number of outgoing linksisUserDataIncluded- whether user data is included in the partition BLOB or not- Throws:
LODNetworkException
-
readNumberOfNodes
int readNumberOfNodes(int linkLevel) throws LODNetworkExceptionRetrieves 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 LODNetworkExceptionRetrieves 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 LODNetworkExceptionRetrieves the array of node IDs in the network.- Parameters:
linkLevel- link level- Returns:
- the array of node IDs in the network
- Throws:
LODNetworkException
-
readLinkIds
long[] readLinkIds(int linkLevel) throws LODNetworkException- Throws:
LODNetworkException
-
readLogicalNodes
LogicalNode[] readLogicalNodes(int linkLevel, int[] userDataCategories) throws LODNetworkException
Returns the nodes on the specified link level.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be loaded- Returns:
- Throws:
LODNetworkException
-
readLogicalLinks
LogicalLink[] readLogicalLinks(int linkLevel, int[] userDataCategories) throws LODNetworkException
Returns the links on the specified link level.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be loaded- Returns:
- Throws:
LODNetworkException
-
readArbitraryLogicalNodes
LogicalNode[] readArbitraryLogicalNodes(int linkLevel, int numberOfNodes, int[] userDataCategories) throws LODNetworkException
Returns an array of arbitrary nodes from the specified link level.- Parameters:
linkLevel- link levelnumberOfNodes- number of nodesuserDataCategories- user data categories to be included- Returns:
- Throws:
LODNetworkException
-
readArbitraryLogicalLinks
LogicalLink[] readArbitraryLogicalLinks(int linkLevel, int numberOfLinks, int[] userDataCategories) throws LODNetworkException
Returns an array of arbitrary links from the specified link level.- Parameters:
linkLevel- link levelnumberOfLinks- number of linksuserDataCategories- user data categories to be included- Returns:
- Throws:
LODNetworkException
-
readArbitraryLogicalNode
LogicalNode readArbitraryLogicalNode(int linkLevel, int[] userDataCategories) throws LODNetworkException
Returns an arbitrary node from the specified link level.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be included- Returns:
- Throws:
LODNetworkException
-
readArbitraryLogicalLink
LogicalLink readArbitraryLogicalLink(int linkLevel, int[] userDataCategories) throws LODNetworkException
Returns an arbitrary link from the specified link level.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be included- Returns:
- Throws:
LODNetworkException
-
readLogicalNetwork
LogicalBasicNetwork readLogicalNetwork(int linkLevel, boolean includeUserData, boolean readFromBlob) throws LODNetworkException
Retrieves the logical network.- Parameters:
linkLevel- link levelincludeUserData- whether to include user data or notreadFromBlob- whether to read from BLOBs or from table- Returns:
- the logical network
- Throws:
LODNetworkException
-
readLogicalNetwork
LogicalBasicNetwork readLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob) throws LODNetworkException
Retrieves the logical network.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be includedreadFromBlob- 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 levelincludeUserData- whether to include user data or not- Returns:
- the logical network
- Throws:
LODNetworkException
-
readLogicalNetwork
LogicalBasicNetwork readLogicalNetwork(int linkLevel, int[] userDataCategories) throws LODNetworkException
Retrieves the logical network.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be included- Returns:
- the logical network
- Throws:
LODNetworkException
-
readLogicalNetwork
LogicalBasicNetwork readLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds) throws LODNetworkException
Retrieves the logical network.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be included- 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 IDlinkLevel- link levelincludeUserData- whether to include user data or notreadFromBlob- whether to read from BLOBs or from table- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartition
LogicalPartition readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, boolean readFromBlob) throws LODNetworkException
Retrieves the logical network partition for the specified partition ID.- Parameters:
partitionId- partition IDlinkLevel- link leveluserDataCategories- user data categories to be includedreadFromBlob- whether to read from BLOBs or from table- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartition
LogicalPartition readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob) throws LODNetworkException
Retrieves the logical network partition for the specified partition ID.- Parameters:
partitionId- partition IDlinkLevel- link leveluserDataCategories- user data categories to be includedfeatureLayerIds- feature layers to be includedreadFromBlob- 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 IDlinkLevel- link levelincludeUserData- whether to include user data or not- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartition
LogicalPartition readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories) throws LODNetworkException
Retrieves the logical network partition for the specified partition ID.- Parameters:
partitionId- partition IDlinkLevel- link leveluserDataCategories- user data categories to be included- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartition
LogicalPartition readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds) throws LODNetworkException
Retrieves the logical network partition for the specified partition ID.- Parameters:
partitionId- partition IDlinkLevel- link leveluserDataCategories- user data categories to be includedfeatureLayerIds- feature layer IDs- 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 levelincludeUserData- whether to include user data or notreadFromBlob- whether to read from BLOBs or from table- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartitions
LogicalPartition[] readLogicalPartitions(int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob) throws LODNetworkException
Retrieves all the logical network partitions.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be includedreadFromBlob- whether to read from BLOBs or from table- Returns:
- logical network partition
- Throws:
LODNetworkException
-
readLogicalPartitions
LogicalPartition[] readLogicalPartitions(int linkLevel, int[] userDataCategories, boolean readFromBlob) throws LODNetworkException
Retrieves all the logical network partitions.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be includedreadFromBlob- 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 levelincludeUserData- whether to include user data or not- Returns:
- all logical network partitions in this network
- Throws:
LODNetworkException
-
readLogicalPartitions
LogicalPartition[] readLogicalPartitions(int linkLevel, int[] userDataCategories) throws LODNetworkException
Retrieves all the logical network partitions in this network.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be included- Returns:
- all logical network partitions in this network
- Throws:
LODNetworkException
-
readLogicalPartitions
LogicalPartition[] readLogicalPartitions(int linkLevel, int[] userDataCategories, int[] featureLayerIds) throws LODNetworkException
Retrieves all the logical network partitions in this network.- Parameters:
linkLevel- link leveluserDataCategories- user data categories to be includedfeatureLayerIds- feature layer IDs- Returns:
- all logical network partitions in this network
- Throws:
LODNetworkException
-
readUserData
void readUserData(LogicalPartition partition, int[] userDataCategories) throws LODNetworkException
Adds user data information to the logical partition- Parameters:
partition- logical partitionuserDataCategories- user data categories to be included- Throws:
LODNetworkException
-
readPartitionId
int readPartitionId(long nodeId, int linkLevel) throws LODNetworkExceptionRetrieves the partition ID for the specified node ID.- Parameters:
nodeId- node IDlinkLevel- link level- Returns:
- partition ID
- Throws:
LODNetworkException
-
readPartitionIds
int[] readPartitionIds(long[] nodeIds, int linkLevel) throws LODNetworkExceptionRetrieves the partition IDs for the specified node IDs.- Parameters:
nodeIds- node IDslinkLevel- link level- Returns:
- partition IDs
- Throws:
LODNetworkException
-
readNodePartitionId
int readNodePartitionId(long nodeId, int linkLevel) throws LODNetworkExceptionRetrieves the partition ID for the specified node ID.- Parameters:
nodeId- node IDlinkLevel- link level- Returns:
- partition ID
- Throws:
LODNetworkException
-
readNodePartitionIds
int[] readNodePartitionIds(long[] nodeIds, int linkLevel) throws LODNetworkExceptionRetrieves the partition IDs for the specified node IDs.- Parameters:
nodeIds- node IDslinkLevel- link level- Returns:
- partition IDs
- Throws:
LODNetworkException
-
readLinkPartitionIds
int[] readLinkPartitionIds(long linkId, int linkLevel) throws LODNetworkExceptionRetrieves the partition IDs for the specified link.- Parameters:
linkId- link IDlinkLevel- link level- Returns:
- array of length 1 if the link is an internal link; array of length 2 if the link is a boundary link; null if the link does not exist on the specified link level of the network.
- Throws:
LODNetworkException
-
readLinkPartitionIds
int[] readLinkPartitionIds(long[] linkIds, int linkLevel) throws LODNetworkExceptionRetrieves the partition IDs for the specified links.- Parameters:
linkIds- link IDslinkLevel- link level- Returns:
- array of length two times the number of the input link IDs. Element 2*i of array contains partition ID of the start node of link i. Element 2*i+1 of the array contains the partition ID of the end node of link i. Both element 2*i and 2*i+1 are set to -1 if link i does not exist on the specified link level of the network.
- Throws:
LODNetworkException
-
readAdjacentPartitionIdsForNodes
LongHashMap<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 IDslinkLevel- link level- Returns:
- relevant partition IDs for each node ID.
- Throws:
LODNetworkException
-
readAdjacentPartitionIdsForLinks
LongHashMap<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 IDslinkLevel- link level- Returns:
- relevant partition IDs for eath node ID.
- Throws:
LODNetworkException
-
readPartitionIds
int[] readPartitionIds(int linkLevel) throws LODNetworkExceptionRetrieves all the partition IDs in the network.- Parameters:
linkLevel- link level- Returns:
- array of partition IDs
- Throws:
LODNetworkException
-
readNumberOfPartitions
int readNumberOfPartitions(int linkLevel) throws LODNetworkExceptionRetrieves the number of partitions in the network.- Parameters:
linkLevel- link level- Returns:
- number of partitions
- Throws:
LODNetworkException
-
readNumberOfConnectedComponents
int readNumberOfConnectedComponents(int linkLevel) throws LODNetworkExceptionRetrieves the number of connected components stored in the component table. This method should be called after the connected components have 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 LODNetworkExceptionRetrieves 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 LODNetworkExceptionRetrieves 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 IDlinkLevel- 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 IDincludeUserData- whether to include the userdata or not- Returns:
- logical link
- Throws:
LODNetworkException
-
readLogicalLink
LogicalLink readLogicalLink(long linkId, int[] userDataCategories) 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 IDuserDataCategories- user data categories to be included- Returns:
- logical link
- Throws:
LODNetworkException
-
readLogicalLinks
LogicalLink[] readLogicalLinks(long[] linkIds, boolean includeUserData) throws LODNetworkException
Retrieves the standalone logical links, i.e., the logical link without references to the start and end nodes, for the specified link ID.- Parameters:
linkIds- link IDincludeUserData- whether to include the userdata or not- Returns:
- logical link
- Throws:
LODNetworkException
-
readLogicalLinks
LogicalLink[] readLogicalLinks(long[] linkIds, int[] userDataCategories) throws LODNetworkException
Retrieves the standalone logical links, i.e., the logical link without references to the start and end nodes, for the specified link ID.- Parameters:
linkIds- link IDuserDataCategories-- 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 IDincludeUserData- 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 IDsincludeUserData- whether to include the userdata or not- Returns:
- logical node
- Throws:
LODNetworkException
-
readLogicalNode
LogicalNode readLogicalNode(long nodeId, int[] userDataCategories) 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 IDuserDataCategories-- Returns:
- logical node
- Throws:
LODNetworkException
-
readLogicalNodes
LogicalNode[] readLogicalNodes(long[] nodeIds, int[] userDataCategories) 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 IDsuserDataCategories-- 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 IDincludeUserData- 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 IDsincludeUserData- whether to include the userdata or not- Returns:
- logical paths
- Throws:
LODNetworkException
-
readLogicalPath
LogicalPath readLogicalPath(long pathId, int[] userDataCategories) throws LODNetworkException
Retrieves the logical path for the specified path ID.- Parameters:
pathId- path IDuserDataCategories-- Returns:
- logical path
- Throws:
LODNetworkException
-
readLogicalPaths
LogicalPath[] readLogicalPaths(long[] pathIds, int[] userDataCategories) throws LODNetworkException
Retrieves the logical paths for the specified path IDs.- Parameters:
pathIds- path IDsuserDataCategories-- 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 IDincludeUserData- 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 IDsincludeUserData- whether to include the userdata or not- Returns:
- logical subpaths
- Throws:
LODNetworkException
-
readLogicalSubPath
LogicalSubPath readLogicalSubPath(long subPathId, int[] userDataCategories) throws LODNetworkException
Retrieves the logical subpath for the specified subpath ID.- Parameters:
subPathId- subpath IDuserDataCategories-- Returns:
- logical subpath
- Throws:
LODNetworkException
-
readLogicalSubPaths
LogicalSubPath[] readLogicalSubPaths(long[] subPathIds, int[] userDataCategories) throws LODNetworkException
Retrieves the logical subpaths for the specified subpath IDs.- Parameters:
subPathIds- subpath IDsuserDataCategories-- 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 informationincludeUserData- 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 informationincludeUserData- whether to include user data or not- Returns:
- heavy logical paths, i.e., logical paths with detailed node and link information
- Throws:
LODNetworkException
-
readLogicalHeavyPath
LogicalHeavyPath readLogicalHeavyPath(LogicalPath path, int[] userDataCategories) throws LODNetworkException
Retrieves node and link information for the specified logical path.- Parameters:
path- logical path without detailed node and link informationuserDataCategories-- Returns:
- Throws:
LODNetworkException
-
readLogicalHeavyPaths
LogicalHeavyPath[] readLogicalHeavyPaths(LogicalPath[] paths, int[] userDataCategories) throws LODNetworkException
Retrieves node and link information for the specified logical paths.- Parameters:
paths- logical paths without detailed node and link informationuserDataCategories-- 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
-
readSpatialPartition
SpatialPartition readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds) throws LODNetworkException
Retrieves spatial partition.- Parameters:
partitionId- partitionIdlinkLevel- linkLeveluserDataCategories- user data categories- Returns:
- spatial network partition
- Throws:
LODNetworkException
-
readSpatialPartition
SpatialPartition readSpatialPartition(int partitionId, int linkLevel, boolean includeUserData) throws LODNetworkException
Retrieves spatial partition.- Parameters:
partitionId- partitionIdlinkLevel- linkLevelincludeUserData- whether to include user data or not- Returns:
- spatial network partition
- Throws:
LODNetworkException
-
readSpatialPartition
SpatialPartition readSpatialPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob) throws LODNetworkException
Retrieves spatial partition.- Parameters:
partitionId- partitionIdlinkLevel- linkLevelincludeUserData- whether to include user data or notreadFromBlob- whether to read from BLOB or not- Returns:
- spatial network partition
- Throws:
LODNetworkException
-
readSpatialPartition
SpatialPartition readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob) throws LODNetworkException
Retrieves spatial partition.- Parameters:
partitionId- partitionIdlinkLevel- linkLeveluserDataCategories- user data categoriesreadFromBlob- whether to read from BLOB or not- 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 IDlinkLevel- 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 IDincludeUserData- whether to include the userdata or not- Returns:
- spatial path
- Throws:
LODNetworkException
-
readSpatialPath
SpatialPath readSpatialPath(long pathId, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial path for the specified path ID.- Parameters:
pathId- path IDuserDataCategories- user data categories to be included- 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 IDincludeUserData- whether to include the userdata or not- Returns:
- spatial path
- Throws:
LODNetworkException
-
readSpatialPaths
SpatialPath[] readSpatialPaths(long[] pathIds, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial path for the specified path ID.- Parameters:
pathIds- path IDuserDataCategories- user data categories to be included- 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 IDincludeUserData- whether to include the userdata or not- Returns:
- spatial subpath
- Throws:
LODNetworkException
-
readSpatialSubPath
SpatialSubPath readSpatialSubPath(long subPathId, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial subpath information.- Parameters:
subPathId- subpath IDuserDataCategories- user data categories to be included- Returns:
- spatial subpath
- Throws:
LODNetworkException
-
readSpatialSubPaths
SpatialSubPath[] readSpatialSubPaths(long[] subPathIds, boolean includeUserData) throws LODNetworkException
Retrieves the spatial subpath information.- Parameters:
subPathIds- subpath IDsincludeUserData- whether to include the userdata or not- Returns:
- spatial subpath
- Throws:
LODNetworkException
-
readSpatialSubPaths
SpatialSubPath[] readSpatialSubPaths(long[] subPathIds, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial subpath information.- Parameters:
subPathIds- subpath IDsuserDataCategories- user data categories to be included- 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 informationincludeUserData- whether to include user data or not- Returns:
- heavy logical path, i.e., logical path with detailed node and link information
- Throws:
LODNetworkException
-
readSpatialHeavyPath
SpatialHeavyPath readSpatialHeavyPath(LogicalPath path, int[] userDataCategories) throws LODNetworkException
Retrieves node and link information for the specified logical paths.- Parameters:
path- logical path without detailed node and link informationuserDataCategories- user data categories to be included- 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 informationincludeUserData- whether to include user data or not- Returns:
- heavy logical paths, i.e., logical paths with detailed node and link information
- Throws:
LODNetworkException
-
readSpatialHeavyPaths
SpatialHeavyPath[] readSpatialHeavyPaths(LogicalPath[] paths, int[] userDataCategories) throws LODNetworkException
Retrieves node and link information for the specified logical paths.- Parameters:
paths- logical paths without detailed node and link informationuserDataCategories- user data categories to be included- 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
-
readSpatialLink
SpatialLink readSpatialLink(long linkId, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial link for the specified link ID.- Parameters:
linkId- link IDuserDataCategories- user data categories to be included- Returns:
- spatial link
- Throws:
LODNetworkException
-
readSpatialLinks
SpatialLink[] readSpatialLinks(long[] linkIds, boolean includeUserData) throws LODNetworkException
Retrieves the spatial links for the specified link IDs.- Parameters:
linkIds- link IDs- Returns:
- spatial links
- Throws:
LODNetworkException
-
readSpatialLinks
SpatialLink[] readSpatialLinks(long[] linkIds, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial links for the specified link IDs.- Parameters:
linkIds- link IDsuserDataCategories- user data categories to be included- Returns:
- spatial links
- 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
-
readSpatialNode
SpatialNode readSpatialNode(long nodeId, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial node for the specified node ID.- Parameters:
nodeId- node IDuserDataCategories- user data categories to be included- Returns:
- spatial node
- Throws:
LODNetworkException
-
readSpatialNodes
SpatialNode[] readSpatialNodes(long[] nodeIds, boolean includeUserData) throws LODNetworkException
Retrieves the spatial nodes for the specified node IDs.- Parameters:
nodeIds- node IDs- Returns:
- spatial nodes
- Throws:
LODNetworkException
-
readSpatialNodes
SpatialNode[] readSpatialNodes(long[] nodeIds, int[] userDataCategories) throws LODNetworkException
Retrieves the spatial nodes for the specified node IDs.- Parameters:
nodeIds- node IDsuserDataCategories- user data categories to be included- Returns:
- spatial nodes
- Throws:
LODNetworkException
-
readNumberOfLinkLevels
int readNumberOfLinkLevels() throws LODNetworkExceptionRetrieves the number of link levels.- Returns:
- number of link levels
- Throws:
LODNetworkException
-
readMaximumLinkLevel
int readMaximumLinkLevel() throws LODNetworkExceptionRetrieves the maximum link level of the network.- Returns:
- maximum link level of the network
- Throws:
LODNetworkException
-
readMaximumLinkLevel
int readMaximumLinkLevel(long nodeId) throws LODNetworkExceptionRetrieves 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 LODNetworkExceptionRetrieves 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 LODNetworkExceptionRetrieves the maximum link level of the outgoing links connected to the specified node.- Parameters:
nodeId- node ID- Returns:
- maximum outgoing link level
- Throws:
LODNetworkException
-
readNetworkUpdate
NetworkUpdate readNetworkUpdate(int linkLevel, long[] updatedNodeIds, long[] deletedNodeIds, long[] updatedLinkIds, long[] deletedLinkIds, int[] userDataCategories) throws LODNetworkException
Constructs network update object according to the changed node and link IDs.- Parameters:
linkLevel- link levelupdatedNodeIds- new and updated node IDsdeletedNodeIds- deleted node IDsupdatedLinkIds- new and updated link IDsdeletedLinkIds- deleted link IDs- Returns:
- network update object
- Throws:
LODNetworkException
-
readNetworkUpdate
NetworkUpdate readNetworkUpdate(int linkLevel, long[] changedNodeIds, long[] changedLinkIds, int[] userDataCategories) throws LODNetworkException
Constructs network update object according to the changed node and link IDs.- Parameters:
linkLevel- link levelchangedNodeIds- new, updated and deleted node IDschangedLinkIds- new, updated and deleted link IDs- Returns:
- network update object
- Throws:
LODNetworkException
-
readNetworkUpdate
NetworkUpdate readNetworkUpdate(int linkLevel, java.util.Calendar lastUpdateTime, int[] userDataCategories) throws LODNetworkException
- Throws:
LODNetworkException
-
readNetworkUpdates
NetworkUpdate[] readNetworkUpdates(java.util.Calendar lastUpdateTime, int[] userDataCategories) throws LODNetworkException
- 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- pathpathName- user specified path namepathType- 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- pathpathId- path IDpathName- user specified path namepathType- 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-pathreferencePathId- reference path IDsubPathName- user specified sub-path namesubPathType- 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-pathsubPathId- sub-path IDreferencePathId- reference path IDsubPathName- user specified sub-path namesubPathType- user specified sub-path type- Throws:
LODNetworkException
-
deletePath
void deletePath(long pathId) throws LODNetworkExceptionDeletes path.- Parameters:
pathId- path ID- Throws:
LODNetworkException
-
deletePaths
void deletePaths(long[] pathIds) throws LODNetworkExceptionDeletes paths.- Parameters:
pathIds- path IDs- Throws:
LODNetworkException
-
deleteSubPath
void deleteSubPath(long subPathId) throws LODNetworkExceptionDeletes sub-path.- Parameters:
subPathId- sub-path ID- Throws:
LODNetworkException
-
deleteSubPaths
void deleteSubPaths(long[] subPathIds) throws LODNetworkExceptionDeletes sub-paths.- Parameters:
subPathIds- sub-path IDs- Throws:
LODNetworkException
-
readNetworkBuffer
NetworkBuffer readNetworkBuffer(long bufferId) throws LODNetworkException
Reads the network buffer with the specified buffer ID. Use network name as the buffer name.- Parameters:
bufferId- ID of the network buffer- Returns:
- Throws:
LODNetworkException
-
readNetworkBuffer
NetworkBuffer readNetworkBuffer(long bufferId, java.lang.String bufferName) throws LODNetworkException
Reads the network buffer with the specified buffer ID.- Parameters:
bufferId- ID of the network bufferbufferName- name of the network buffer- Returns:
- Throws:
LODNetworkException
-
writeNetworkBuffer
long writeNetworkBuffer(NetworkBuffer buffer) throws LODNetworkException
Stores the network buffer into the database. An ID will be automatically assigned to this buffer. Network name is used as buffer name.- Parameters:
buffer- network buffer to be stored- Returns:
- the ID of the network buffer
- Throws:
LODNetworkException
-
writeNetworkBuffer
long writeNetworkBuffer(NetworkBuffer buffer, java.lang.String bufferName) throws LODNetworkException
Stores the network buffer into the database. An ID will be automatically assigned to this buffer.- Parameters:
buffer- network buffer to be stored- Returns:
- the ID of the network buffer
- Throws:
LODNetworkException
-
writeNetworkBuffer
void writeNetworkBuffer(NetworkBuffer networkBuffer, long bufferId) throws LODNetworkException
Stores the network buffer into the database. Use the network name as the buffer name.- Parameters:
networkBuffer- network buffer to be storedbufferId- ID of the network buffer in the database- Throws:
LODNetworkException
-
writeNetworkBuffer
void writeNetworkBuffer(NetworkBuffer networkBuffer, long bufferId, java.lang.String bufferName) throws LODNetworkException
Stores the network buffer into the database.- Parameters:
networkBuffer- network buffer to be storedbufferId- ID of the network buffer in the database- Throws:
LODNetworkException
-
deleteNetworkBuffer
void deleteNetworkBuffer(long id) throws LODNetworkExceptionDeletes the network buffer from the database. Use the network name as buffer name.- Parameters:
id- ID of the network buffer- Throws:
LODNetworkException
-
deleteNetworkBuffer
void deleteNetworkBuffer(long id, java.lang.String bufferName) throws LODNetworkExceptionDeletes the network buffer from the database.- Parameters:
id- ID of the network bufferbufferName- name of the network buffer- 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 LODNetworkExceptionGenerates partition BLOBs for the specified link level. This method reads partition information from the network node and link tables/views directly, and writes the partition information to BLOB.- Parameters:
linkLevel- link levelincludeUserData- whether to include user data or not. If set to true, user data of category 0 will be included in the blob.commitForEachBlob- whether to call commit after writing the BLOB for each partition- Throws:
LODNetworkException
-
generatePartitionBlobs
void generatePartitionBlobs(boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate) throws LODNetworkExceptionGenerates partition BLOBs for all link levels. Depending on the value of the flag performDeltaUpdate, partition information can be read from the original network node and link tables/views, or from the existing partition BLOBs combined with the information from the network update history table.- Parameters:
includeUserData- whether to include user data or not. If set to true, user data of category 0 will be included in the blob.commitForEachBlob- whether to call commit after writing the BLOB for each partitionperformDeltaUpdate- whether to use network update history to perform delta update on existing BLOBs or to reload the network information directly from the network node and link tables/views.- Throws:
LODNetworkException- Since:
- 11gR2
-
generatePartitionBlobs
void generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate) throws LODNetworkExceptionGenerates partition BLOBs for the specified link level. Depending on the value of the flag performDeltaUpdate, partition information can be read from the original network node and link tables/views, or from the existing partition BLOBs combined with the information from the network update history table.- Parameters:
linkLevel- link levelincludeUserData- whether to include user data or not. If set to true, user data of category 0 will be included in the blob.commitForEachBlob- whether to call commit after writing the BLOB for each partitionperformDeltaUpdate- whether to use network update history to perform delta update on existing BLOBs or to reload the network information directly from the network node and link tables/views.- Throws:
LODNetworkException- Since:
- 11gR2
-
generatePartitionBlob
void generatePartitionBlob(int partitionId, int linkLevel, boolean includeUserData) throws LODNetworkExceptionGenerate partition BLOB for the specified partition. This method reads partition information from the original network node and link tables/views directly, and writes the partition information to BLOB.- Parameters:
partitionId- partition IDlinkLevel- link levelincludeUserData- whether to include user data or not. If set to true, user data of category 0 will be included in the blob.- Throws:
LODNetworkException
-
generatePartitionBlob
void generatePartitionBlob(int partitionId, int linkLevel, boolean includeUserData, boolean performDeltaUpdate) throws LODNetworkExceptionGenerates partition BLOB for the specified partition. Depending on the value of the flag performDeltaUpdate, partition information can be read from the original network node and link tables/views, or from the existing partition BLOB combined with the information from the network update history table.- Parameters:
partitionId- partition IDlinkLevel- link levelincludeUserData- whether to include user data or not. If set to true, user data of category 0 will be included in the blob.performDeltaUpdate- whether to use network update history to perform delta update on existing BLOBs or to reload the network information directly from the network node and link tables/views.- Throws:
LODNetworkException- Since:
- 11gR2
-
getNextTmpNodeId
long getNextTmpNodeId()
Returns the next temporary node ID.- Returns:
-
getNextTmpLinkId
long getNextTmpLinkId()
Returns the next temporary link ID.- Returns:
-
readFeatureData
void readFeatureData(LogicalPartition partition, int[] featureLayerIds, int[] userDataCategories) throws LODNetworkException
Adds feature data to the logical partition- Parameters:
partition- logical partitionfeatureLayerIds- feature layer IDs- Throws:
LODNetworkException
-
readFeatures
Feature[] readFeatures(int featureLayerId, long[] featureIds, int[] userDataCategories) throws LODNetworkException
Read features.- Parameters:
featureIds- feature IDs- Throws:
LODNetworkException
-
computeFeatureGeometries
JGeometry[] computeFeatureGeometries(Feature[] features, int nodeGeomUserDataCategory, int nodeGeomUserDataIndex, int linkGeomUserDataCategory, int linkGeomUserDataIndex, boolean consolidate) throws LODNetworkException
Constructs the feature geometry from the geometries of its network elements.- Parameters:
features-nodeGeomUserDataCategory-nodeGeomUserDataIndex-linkGeomUserDataCategory-linkGeomUserDataIndex-consolidate- whether to consolidate the overlapping points into one point and connect the links that touches each other into one link- Returns:
- Throws:
LODNetworkException
-
-