Package 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
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description void
close()
void
commit()
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.void
deleteNetworkBuffer(long id)
Deletes the network buffer from the database.void
deleteNetworkBuffer(long id, java.lang.String bufferName)
Deletes the network buffer from 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
generatePartitionBlob(int partitionId, int linkLevel, boolean includeUserData, boolean performDeltaUpdate)
Generates partition BLOB for the specified partition.void
generatePartitionBlobs(boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)
Generates partition BLOBs for all link levels.void
generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob)
Generates partition BLOBs for the specified link level.void
generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)
Generates partition BLOBs for the specified link level.java.sql.Connection
getConnection()
Deprecated.use getDataSource insteadoracle.spatial.network.ds.IDataSource
getDataSource()
Returns the data source.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.NetworkIOConfig
getNetworkIOConfig()
Returns the network IO configuration.NetworkMetadata
getNetworkMetadata()
Returns the network metadata.java.lang.String
getNetworkName()
Returns the network name used in network metadata.long
getNextId()
Returns the next value from the NDM ID sequence.long
getNextTmpLinkId()
Returns the next temporary link ID.long
getNextTmpNodeId()
Returns the next temporary node ID.PartitionBlobTranslator
getPartitionBlobTranslator()
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 notboolean
isReadFromBlob()
Returns true if the partitions are read from BLOB; false if the partitions are read from node/link tables.void
open()
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.LogicalLink
readArbitraryLogicalLink(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.LogicalNode
readArbitraryLogicalNode(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.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.void
readFeatureData(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.LogicalHeavyPath
readLogicalHeavyPath(LogicalPath path, boolean includeUserData)
Retrieves node and link information for the specified logical path.LogicalHeavyPath
readLogicalHeavyPath(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.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
readLogicalLink(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.LogicalBasicNetwork
readLogicalNetwork(int linkLevel, boolean includeUserData)
Retrieves the logical network.LogicalBasicNetwork
readLogicalNetwork(int linkLevel, boolean includeUserData, boolean readFromBlob)
Retrieves the logical network.LogicalBasicNetwork
readLogicalNetwork(int linkLevel, int[] userDataCategories)
Retrieves the logical network.LogicalBasicNetwork
readLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds)
Retrieves the logical network.LogicalBasicNetwork
readLogicalNetwork(int linkLevel, int[] userDataCategories, int[] featureLayerIds, 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
readLogicalNode(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.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
readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories)
Retrieves the logical network partition for the specified partition ID.LogicalPartition
readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, boolean readFromBlob)
Retrieves the logical network partition for the specified partition ID.LogicalPartition
readLogicalPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds)
Retrieves the logical network partition for the specified partition ID.LogicalPartition
readLogicalPartition(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.LogicalPath
readLogicalPath(long pathId, boolean includeUserData)
Retrieves the logical path for the specified path ID.LogicalPath
readLogicalPath(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.LogicalSubPath
readLogicalSubPath(long subPathId, boolean includeUserData)
Retrieves the logical subpath for the specified subpath ID.LogicalSubPath
readLogicalSubPath(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.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.NetworkBuffer
readNetworkBuffer(long bufferId)
Reads the network buffer with the specified buffer ID.NetworkBuffer
readNetworkBuffer(long bufferId, java.lang.String bufferName)
Reads the network buffer with the specified buffer ID.NetworkUpdate
readNetworkUpdate(int linkLevel, long[] changedNodeIds, long[] changedLinkIds, int[] userDataCategories)
Constructs network update object according to the changed node and link IDs.NetworkUpdate
readNetworkUpdate(int linkLevel, long[] updatedNodeIds, long[] deletedNodeIds, long[] updatedLinkIds, long[] deletedLinkIds, int[] userDataCategories)
Constructs network update object according to the changed node and link IDs.NetworkUpdate
readNetworkUpdate(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.int
readNodePartitionId(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.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
readSpatialHeavyPath(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.SpatialLink
readSpatialLink(long linkId, boolean includeUserData)
Retrieves the spatial link for the specified link ID.SpatialLink
readSpatialLink(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.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.SpatialNode
readSpatialNode(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.SpatialPartition
readSpatialPartition(int partitionId, int linkLevel, boolean includeUserData)
Retrieves spatial partition.SpatialPartition
readSpatialPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob)
Retrieves spatial partition.SpatialPartition
readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds)
Retrieves spatial partition.SpatialPartition
readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, int[] featureLayerIds, boolean readFromBlob)
Retrieves spatial partition.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(long pathId, boolean includeUserData)
Retrieves the spatial path for the specified path ID.SpatialPath
readSpatialPath(long pathId, int[] userDataCategories)
Retrieves the spatial path for the specified path ID.SpatialPath
readSpatialPath(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.SpatialSubPath
readSpatialSubPath(long subPathId, boolean includeUserData)
Retrieves the spatial subpath information.SpatialSubPath
readSpatialSubPath(long subPathId, int[] userDataCategories)
Retrieves the spatial subpath information.SpatialSubPath
readSpatialSubPath(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.void
readUserData(LogicalPartition partition, int[] userDataCategories)
Adds user data information to the logical partitionvoid
rollback()
Sends out rollback command to the database.void
saveConnectedComponents(OrderedLongSet[] components, int linkLevel)
Stores the connected components information in the component table.void
setConnection(java.sql.Connection conn)
Deprecated.use setDataSource insteadvoid
setDataSource(oracle.spatial.network.ds.IDataSource dataSource)
Sets the data source.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.void
setNetworkMetadata(NetworkMetadata metadata)
Sets network metadatavoid
setPartitionBlobTranslator(PartitionBlobTranslator translator)
Sets the partition blob translator.void
setReadFromBlob(boolean readFromBlob)
Sets whether to read partitions from BLOBs.void
setUserDataIOs(LODUserDataIO[] udios)
Sets the user data IO implementations.void
updatePartitionBlobInfo(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.long
writeNetworkBuffer(NetworkBuffer buffer)
Stores the network buffer into the database.void
writeNetworkBuffer(NetworkBuffer networkBuffer, long bufferId)
Stores the network buffer into the database.void
writeNetworkBuffer(NetworkBuffer networkBuffer, long bufferId, java.lang.String bufferName)
Stores the network buffer into the database.long
writeNetworkBuffer(NetworkBuffer buffer, java.lang.String bufferName)
Stores the network buffer into the database.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
-
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 LODNetworkException
Sends out commit command to the database.- Throws:
LODNetworkException
-
rollback
void rollback() throws LODNetworkException
Sends out rollback command to the database.- Throws:
LODNetworkException
-
getNextId
long getNextId() throws LODNetworkException
Returns the next value from the NDM ID sequence.- Returns:
- 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
-
hasNodes
boolean[] hasNodes(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
-
hasLinks
boolean[] hasLinks(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
-
updatePartitionBlobInfo
void updatePartitionBlobInfo(int partitionId, int linkLevel, int numberOfInternalNodes, int numberOfExternalNodes, int numberOfInternalLinks, int numberOfBoundaryLinks, int numberOfIncomingLinks, int numberOfOutgoingLinks, boolean isUserDataIncluded) throws LODNetworkException
Updates 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 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
-
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 LODNetworkException
Retrieves 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 LODNetworkException
Retrieves 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 LODNetworkException
Retrieves 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 LODNetworkException
Retrieves 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 LODNetworkException
Retrieves 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 LODNetworkException
Retrieves 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 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 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 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 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 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
-
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 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
-
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 LODNetworkException
Deletes 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 LODNetworkException
Deletes 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 LODNetworkException
Generates 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 LODNetworkException
Generates 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 LODNetworkException
Generates 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 LODNetworkException
Generate 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 LODNetworkException
Generates 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
-
-