NetworkIO (Oracle Spatial Java API Reference)

Overview

Package

Class

Tree

Deprecated

Index

Help

Oracle® Spatial Java API Reference
11g Release 2 (11.2)
E11829-02

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

oracle.spatial.network.lod
Interface NetworkIO

All Known Subinterfaces:: CachedNetworkIO, CachedNetworkIOWM

public interface NetworkIO

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

Since:: 11gR1

Method Summary
`void`	`commit()` Sends out commit command to the database.
`void`	`deleteNetworkBuffer(long id)` 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)` Deprecated.
`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)` Deprecated. use generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)
`void`	`generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)` Generates partition BLOBs for the specified link level.
`java.lang.String`	`getGlobalNetworkName()` Returns the global network name, i.e., the network name that is globally unique, and is used as the cache key for the network.
`oracle.spatial.network.lod.LODNetworkAdaptor`	`getNetworkAdaptor()` Returns the network adaptor
`NetworkMetadata`	`getNetworkMetadata()` Returns the network metadata.
`long`	`getNextTmpLinkId()` Returns the next temporary link ID.
`long`	`getNextTmpNodeId()` Returns the next temporary node ID.
`LODUserDataIO[]`	`getUserDataIOs()` Returns the user data IO implementation.
`boolean[]`	`hasLinks(long[] linkIds)` Checks whether the input links exist or not
`boolean[]`	`hasNodes(long[] nodeIds)` Checks whether the input nodes exist or not
`boolean[]`	`isLinksExist(long[] linkIds)` Deprecated. use hasLinks
`boolean[]`	`isNodesExist(long[] nodeIds)` Deprecated. use hasNodes
`java.io.OutputStream`	`openPartitionBlobOutputStream(int partitionId, int linkLevel)` Opens the partition BLOB output stream.
`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.
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalHeavyPath`	`readLogicalHeavyPath(LogicalPath path, int[] userDataCategories)` Retrieves node and link information for the specified logical path.
`LogicalHeavyPath[]`	`readLogicalHeavyPaths(LogicalPath[] paths, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalHeavyPath[]`	`readLogicalHeavyPaths(LogicalPath[] paths, int[] userDataCategories)` Retrieves node and link information for the specified logical paths.
`LogicalLink`	`readLogicalLink(long linkId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalBasicNetwork`	`readLogicalNetwork(int linkLevel, boolean includeUserData, boolean readFromBlob)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalBasicNetwork`	`readLogicalNetwork(int linkLevel, int[] userDataCategories)` Retrieves the logical network.
`LogicalBasicNetwork`	`readLogicalNetwork(int linkLevel, int[] userDataCategories, boolean readFromBlob)` Retrieves the logical network.
`LogicalNode`	`readLogicalNode(long nodeId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalPartition`	`readLogicalPartition(int partitionId, int linkLevel, boolean includeUserData, boolean readFromBlob)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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[]`	`readLogicalPartitions(int linkLevel, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalPartition[]`	`readLogicalPartitions(int linkLevel, boolean includeUserData, boolean readFromBlob)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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.
`LogicalPath`	`readLogicalPath(long pathId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalPath`	`readLogicalPath(long pathId, int[] userDataCategories)` Retrieves the logical path for the specified path ID.
`LogicalPath[]`	`readLogicalPaths(long[] pathIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalPath[]`	`readLogicalPaths(long[] pathIds, int[] userDataCategories)` Retrieves the logical paths for the specified path IDs.
`LogicalSubPath`	`readLogicalSubPath(long subPathId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`LogicalSubPath`	`readLogicalSubPath(long subPathId, int[] userDataCategories)` Retrieves the logical subpath for the specified subpath ID.
`LogicalSubPath[]`	`readLogicalSubPaths(long[] subPathIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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.
`NetworkUpdate`	`readNetworkUpdate(int linkLevel, java.util.Calendar lastUpdateTime, int[] userDataCategories)`
`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[]`	`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)` Deprecated. use readNodePartitionId
`int[]`	`readPartitionIds(int linkLevel)` Retrieves all the partition IDs in the network.
`int[]`	`readPartitionIds(long[] nodeIds, int linkLevel)` Deprecated. use readNodePartitionIds
`SpatialHeavyPath`	`readSpatialHeavyPath(LogicalPath path, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialHeavyPath`	`readSpatialHeavyPath(LogicalPath path, int[] userDataCategories)` Retrieves node and link information for the specified logical paths.
`SpatialHeavyPath[]`	`readSpatialHeavyPaths(LogicalPath[] paths, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialHeavyPath[]`	`readSpatialHeavyPaths(LogicalPath[] paths, int[] userDataCategories)` Retrieves node and link information for the specified logical paths.
`SpatialLink`	`readSpatialLink(long linkId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialLink`	`readSpatialLink(long linkId, int[] userDataCategories)` Retrieves the spatial link for the specified link ID.
`SpatialLink[]`	`readSpatialLinks(long[] linkIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialNode`	`readSpatialNode(long nodeId, int[] userDataCategories)` Retrieves the spatial node for the specified node ID.
`SpatialNode[]`	`readSpatialNodes(long[] nodeIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`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)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialPartition`	`readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialPartition`	`readSpatialPartition(int partitionId, int linkLevel, int[] userDataCategories, 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(LogicalPath logicalPath)` Retrieves the spatial information for the specified logical path, and returns the spatial path.
`SpatialPath`	`readSpatialPath(long pathId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialPath`	`readSpatialPath(long pathId, 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.
`SpatialPath[]`	`readSpatialPaths(long[] pathIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialPath[]`	`readSpatialPaths(long[] pathIds, int[] userDataCategories)` Retrieves the spatial path for the specified path ID.
`SpatialSubPath`	`readSpatialSubPath(LogicalSubPath logicalSubPath)` Retrieves the spatial information of the specified logical subpath, and returns the spatial subpath.
`SpatialSubPath`	`readSpatialSubPath(long subPathId, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialSubPath`	`readSpatialSubPath(long subPathId, 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.
`SpatialSubPath[]`	`readSpatialSubPaths(long[] subPathIds, boolean includeUserData)` Deprecated. use ...(..., int[] userDataCategories, ...)
`SpatialSubPath[]`	`readSpatialSubPaths(long[] subPathIds, int[] userDataCategories)` Retrieves the spatial subpath information.
`void`	`readUserData(LogicalPartition partition, int[] userDataCategories)` Add user data information to the logical partition
`void`	`rollback()` Sends out rollback command to the database.
`void`	`saveConnectedComponents(OrderedLongSet[] components, int linkLevel)` Stores the connected components information in the component table.
`void`	`setNetworkAdaptor(oracle.spatial.network.lod.LODNetworkAdaptor adaptor)` Sets the network adaptor.
`void`	`setNetworkMetadata(NetworkMetadata metadata)` Sets network metadata
`void`	`setUserDataIOs(LODUserDataIO[] udios)` Sets the user data IO implementation.
`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 buffer, long bufferId)` 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

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

getNetworkAdaptor

oracle.spatial.network.lod.LODNetworkAdaptor getNetworkAdaptor()

Returns the network adaptor

Returns:

setNetworkAdaptor

void setNetworkAdaptor(oracle.spatial.network.lod.LODNetworkAdaptor adaptor)

Sets the network adaptor.

Parameters:: adaptor - network adaptor

getNetworkMetadata

NetworkMetadata getNetworkMetadata()

Returns the network metadata.

Returns:: network metadata

setNetworkMetadata

void setNetworkMetadata(NetworkMetadata metadata)

Sets network metadata

Parameters:: metadata - network metadata

getUserDataIOs

LODUserDataIO[] getUserDataIOs()

Returns the user data IO implementation.

Returns:: user data IO implementation

setUserDataIOs

void setUserDataIOs(LODUserDataIO[] udios)

Sets the user data IO implementation.

Parameters:: udios -

commit

void commit()
            throws LODNetworkException

Sends out commit command to the database.

Throws:: LODNetworkException

rollback

void rollback()
              throws LODNetworkException

Sends out rollback command to the database.

Throws:: LODNetworkException

isNodesExist

boolean[] isNodesExist(long[] nodeIds)
                       throws LODNetworkException

Deprecated. use hasNodes

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

Deprecated. use hasLinks

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

openPartitionBlobOutputStream

java.io.OutputStream openPartitionBlobOutputStream(int partitionId,
                                                   int linkLevel)
                                                   throws LODNetworkException

Opens the partition BLOB output stream.

Parameters:: partitionId - partition ID; linkLevel - link level
Returns:: partition BLOB output stream
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 ID; linkLevel - link level; numberOfInternalNodes - number of internal nodes; numberOfExternalNodes - number of external nodes; numberOfInternalLinks - number of internal links; numberOfBoundaryLinks - number of boundary links; numberOfIncomingLinks - number of incoming links; numberOfOutgoingLinks - number of outgoing links; isUserDataIncluded - 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 level; userDataCategories - 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 level; userDataCategories - 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 level; numberOfNodes - number of nodes; userDataCategories - 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 level; numberOfLinks - number of links; userDataCategories - 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 level; userDataCategories - 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 level; userDataCategories - user data categories to be included
Returns:
Throws:: LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       boolean includeUserData,
                                       boolean readFromBlob)
                                       throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical network.

Parameters:: linkLevel - link level; includeUserData - whether to include user data or not; readFromBlob - whether to read from BLOBs or from table
Returns:: the logical network
Throws:: LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       int[] userDataCategories,
                                       boolean readFromBlob)
                                       throws LODNetworkException

Retrieves the logical network.

Parameters:: linkLevel - link level; userDataCategories - user data categories to be included; readFromBlob - whether to read from BLOBs or from table
Returns:: the logical network
Throws:: LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       boolean includeUserData)
                                       throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical network. Whether the network is loaded from BLOBs or from node and link tables depends on how it is configured in the LOD configuration xml.

Parameters:: linkLevel - link level; includeUserData - whether to include user data or not
Returns:: the logical network
Throws:: LODNetworkException

readLogicalNetwork

LogicalBasicNetwork readLogicalNetwork(int linkLevel,
                                       int[] userDataCategories)
                                       throws LODNetworkException

Retrieves the logical network.

Parameters:: linkLevel - link level; userDataCategories - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical network partition for the specified partition ID.

Parameters:: partitionId - partition ID; linkLevel - link level; includeUserData - whether to include user data or not; readFromBlob - whether to read from BLOBs or from table
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartition

LogicalPartition readLogicalPartition(int partitionId,
                                      int linkLevel,
                                      int[] userDataCategories,
                                      boolean readFromBlob)
                                      throws LODNetworkException

Retrieves the logical network partition for the specified partition ID.

Parameters:: partitionId - partition ID; linkLevel - link level; userDataCategories - user data categories to be included; readFromBlob - whether to read from BLOBs or from table
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartition

LogicalPartition readLogicalPartition(int partitionId,
                                      int linkLevel,
                                      boolean includeUserData)
                                      throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical network partition for the specified partition ID. Whether the network partition is loaded from BLOBs or from node and link tables depends on how it is configured in the LOD configuration xml.

Parameters:: partitionId - partition ID; linkLevel - link level; includeUserData - whether to include user data or not
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartition

LogicalPartition readLogicalPartition(int partitionId,
                                      int linkLevel,
                                      int[] userDataCategories)
                                      throws LODNetworkException

Retrieves the logical network partition for the specified partition ID.

Parameters:: partitionId - partition ID; linkLevel - link level; userDataCategories - user data categories to be included
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         boolean includeUserData,
                                         boolean readFromBlob)
                                         throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves all the logical network partitions.

Parameters:: linkLevel - link level; includeUserData - whether to include user data or not; readFromBlob - whether to read from BLOBs or from table
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         int[] userDataCategories,
                                         boolean readFromBlob)
                                         throws LODNetworkException

Retrieves all the logical network partitions.

Parameters:: linkLevel - link level; userDataCategories - user data categories to be included; readFromBlob - whether to read from BLOBs or from table
Returns:: logical network partition
Throws:: LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         boolean includeUserData)
                                         throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves all the logical network partitions in this network.

Parameters:: linkLevel - link level; includeUserData - whether to include user data or not
Returns:: all logical network partitions in this network
Throws:: LODNetworkException

readLogicalPartitions

LogicalPartition[] readLogicalPartitions(int linkLevel,
                                         int[] userDataCategories)
                                         throws LODNetworkException

Retrieves all the logical network partitions in this network.

Parameters:: linkLevel - link level; userDataCategories - user data categories to be included
Returns:: all logical network partitions in this network
Throws:: LODNetworkException

readUserData

void readUserData(LogicalPartition partition,
                  int[] userDataCategories)
                  throws LODNetworkException

Add user data information to the logical partition

Parameters:: partition - logical partition; userDataCategories - user data categories to be included
Throws:: LODNetworkException

readPartitionId

int readPartitionId(long nodeId,
                    int linkLevel)
                    throws LODNetworkException

Deprecated. use readNodePartitionId

Retrieves the partition ID for the specified node ID.

Parameters:: nodeId - node ID; linkLevel - link level
Returns:: partition ID
Throws:: LODNetworkException

readPartitionIds

int[] readPartitionIds(long[] nodeIds,
                       int linkLevel)
                       throws LODNetworkException

Deprecated. use readNodePartitionIds

Retrieves the partition IDs for the specified node IDs.

Parameters:: nodeIds - node IDs; linkLevel - 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 ID; linkLevel - 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 IDs; linkLevel - 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 ID; linkLevel - 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 exsit 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 IDs; linkLevel - 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 IDs; linkLevel - link level
Returns:: relevant partition IDs for eath 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 IDs; linkLevel - link level
Returns:: relevant partition IDs for eath node ID.
Throws:: LODNetworkException

readPartitionIds

int[] readPartitionIds(int linkLevel)
                       throws LODNetworkException

Retrieves all the partition IDs in the network.

Parameters:: linkLevel - link level
Returns:: array of partition IDs
Throws:: LODNetworkException

readNumberOfPartitions

int readNumberOfPartitions(int linkLevel)
                           throws LODNetworkException

Retrieves the number of partitions in the network.

Parameters:: linkLevel - link level
Returns:: number of partitions
Throws:: LODNetworkException

readNumberOfConnectedComponents

int readNumberOfConnectedComponents(int linkLevel)
                                    throws LODNetworkException

Retrieves the number of connected components stored in the component table. This method should be called after the connected components habe been pre-computed and stored in the database.

Parameters:: linkLevel - link level
Returns:: number of connected components, if the connected components have been pre-computed and stored in the database;
-1, otherwise
Throws:: LODNetworkException

readComponentIds

int[] readComponentIds(int linkLevel)
                       throws LODNetworkException

Retrieves the component IDs stored in the connected component table. This method should be called after the connected components habe been pre-computed and stored in the database.

Parameters:: linkLevel - link level
Returns:: the component ID array, if the connected components have been pre-computed and stored in the database;
null, otherwise
Throws:: LODNetworkException

readComponentId

int readComponentId(long nodeId,
                    int linkLevel)
                    throws LODNetworkException

Retrieves the component ID assigned to the specified node ID. This method should be called after the connected components habe been pre-computed and stored in the database.

Parameters:: nodeId - node ID; linkLevel - link level
Returns:: the component ID assigned to the specified node ID, if the connected components have been pre-computed and stored in the database;
-1, otherwise
Throws:: LODNetworkException

readLogicalLink

LogicalLink readLogicalLink(long linkId,
                            boolean includeUserData)
                            throws LODNetworkException

Deprecated. use ...(..., 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.

Parameters:: linkId - link ID; includeUserData - 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 ID; userDataCategories - user data categories to be included
Returns:: logical link
Throws:: LODNetworkException

readLogicalLinks

LogicalLink[] readLogicalLinks(long[] linkIds,
                               boolean includeUserData)
                               throws LODNetworkException

Deprecated. use ...(..., 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.

Parameters:: linkIds - link ID; includeUserData - 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 ID; userDataCategories -
Returns:: logical link
Throws:: LODNetworkException

readLogicalNode

LogicalNode readLogicalNode(long nodeId,
                            boolean includeUserData)
                            throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the standalone logical node, i.e., the logical node without references to incoming and outgoing links, for the specified node ID.

Parameters:: nodeId - node ID; includeUserData - whether to include the userdata or not
Returns:: logical node
Throws:: LODNetworkException

readLogicalNodes

LogicalNode[] readLogicalNodes(long[] nodeIds,
                               boolean includeUserData)
                               throws LODNetworkException

Retrieves the standalone logical nodes, i.e., the logical nodes without references to incoming and outgoing links, for the specified node IDs.

Parameters:: nodeIds - node IDs; includeUserData - whether to include the userdata or not
Returns:: logical node
Throws:: LODNetworkException

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 ID; userDataCategories -
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 IDs; userDataCategories -
Returns:: logical node
Throws:: LODNetworkException

readLogicalPath

LogicalPath readLogicalPath(long pathId,
                            boolean includeUserData)
                            throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical path for the specified path ID.

Parameters:: pathId - path ID; includeUserData - whether to include the userdata or not
Returns:: logical path
Throws:: LODNetworkException

readLogicalPaths

LogicalPath[] readLogicalPaths(long[] pathIds,
                               boolean includeUserData)
                               throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical paths for the specified path IDs.

Parameters:: pathIds - path IDs; includeUserData - whether to include the userdata or not
Returns:: logical paths
Throws:: LODNetworkException

readLogicalPath

LogicalPath readLogicalPath(long pathId,
                            int[] userDataCategories)
                            throws LODNetworkException

Retrieves the logical path for the specified path ID.

Parameters:: pathId - path ID; userDataCategories -
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 IDs; userDataCategories -
Returns:: logical paths
Throws:: LODNetworkException

readLogicalSubPath

LogicalSubPath readLogicalSubPath(long subPathId,
                                  boolean includeUserData)
                                  throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical subpath for the specified subpath ID.

Parameters:: subPathId - subpath ID; includeUserData - whether to include the userdata or not
Returns:: logical subpath
Throws:: LODNetworkException

readLogicalSubPaths

LogicalSubPath[] readLogicalSubPaths(long[] subPathIds,
                                     boolean includeUserData)
                                     throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the logical subpaths for the specified subpath IDs.

Parameters:: subPathIds - subpath IDs; includeUserData - whether to include the userdata or not
Returns:: logical subpaths
Throws:: LODNetworkException

readLogicalSubPath

LogicalSubPath readLogicalSubPath(long subPathId,
                                  int[] userDataCategories)
                                  throws LODNetworkException

Retrieves the logical subpath for the specified subpath ID.

Parameters:: subPathId - subpath ID; userDataCategories -
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 IDs; userDataCategories -
Returns:: logical subpaths
Throws:: LODNetworkException

readLogicalHeavyPath

LogicalHeavyPath readLogicalHeavyPath(LogicalPath path,
                                      boolean includeUserData)
                                      throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves node and link information for the specified logical path.

Parameters:: path - logical path without detailed node and link information; includeUserData - whether to include user data or not
Returns:
Throws:: LODNetworkException

readLogicalHeavyPaths

LogicalHeavyPath[] readLogicalHeavyPaths(LogicalPath[] paths,
                                         boolean includeUserData)
                                         throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves node and link information for the specified logical paths.

Parameters:: paths - logical paths without detailed node and link information; includeUserData - whether to include user data or not
Returns:: heavy logical paths, i.e., logical paths with detailed node and link information
Throws:: LODNetworkException

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 information; userDataCategories -
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 information; userDataCategories -
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)
                                      throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves spatial partition.

Parameters:: partitionId - partitionId; linkLevel - linkLevel; userDataCategories - 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 - partitionId; linkLevel - linkLevel; includeUserData - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves spatial partition.

Parameters:: partitionId - partitionId; linkLevel - linkLevel; includeUserData - whether to include user data or not; readFromBlob - whether to read from BLOB or not
Returns:: spatial network partition
Throws:: LODNetworkException

readSpatialPartition

SpatialPartition readSpatialPartition(int partitionId,
                                      int linkLevel,
                                      int[] userDataCategories,
                                      boolean readFromBlob)
                                      throws LODNetworkException

Retrieves spatial partition.

Parameters:: partitionId - partitionId; linkLevel - linkLevel; userDataCategories - user data categories; readFromBlob - 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 ID; linkLevel - link level
Returns:: a polygon type JGeometry instance representing the MBR
Throws:: LODNetworkException

readSpatialPartitionMBRs

java.util.Map<java.lang.Integer,JGeometry> readSpatialPartitionMBRs(int linkLevel)
                                                                    throws LODNetworkException

Returns the minimum bounding rectangles (MBR) of all the partitions in this network.

Parameters:: linkLevel - link level
Returns:: a map, whose keys are the partition IDs in the network, and whose values are polygon type JGeometry instances representing the MBRs of the corresponding partitions.
Throws:: LODNetworkException

readSpatialPath

SpatialPath readSpatialPath(long pathId,
                            boolean includeUserData)
                            throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the spatial path for the specified path ID.

Parameters:: pathId - path ID; includeUserData - whether to include the userdata or not
Returns:: spatial path
Throws:: LODNetworkException

readSpatialPath

SpatialPath readSpatialPath(long pathId,
                            int[] userDataCategories)
                            throws LODNetworkException

Retrieves the spatial path for the specified path ID.

Parameters:: pathId - path ID; userDataCategories - user data categories to be included
Returns:: spatial path
Throws:: LODNetworkException

readSpatialPaths

SpatialPath[] readSpatialPaths(long[] pathIds,
                               boolean includeUserData)
                               throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the spatial path for the specified path ID.

Parameters:: pathIds - path ID; includeUserData - whether to include the userdata or not
Returns:: spatial path
Throws:: LODNetworkException

readSpatialPaths

SpatialPath[] readSpatialPaths(long[] pathIds,
                               int[] userDataCategories)
                               throws LODNetworkException

Retrieves the spatial path for the specified path ID.

Parameters:: pathIds - path ID; userDataCategories - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the spatial subpath information.

Parameters:: subPathId - subpath ID; includeUserData - 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 ID; userDataCategories - user data categories to be included
Returns:: spatial subpath
Throws:: LODNetworkException

readSpatialSubPaths

SpatialSubPath[] readSpatialSubPaths(long[] subPathIds,
                                     boolean includeUserData)
                                     throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves the spatial subpath information.

Parameters:: subPathIds - subpath IDs; includeUserData - 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 IDs; userDataCategories - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves node and link information for the specified logical paths.

Parameters:: path - logical path without detailed node and link information; includeUserData - whether to include user data or not
Returns:: heavy logical path, i.e., logical path with detailed node and link information
Throws:: LODNetworkException

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 information; userDataCategories - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

Retrieves node and link information for the specified logical paths.

Parameters:: paths - logical paths without detailed node and link information; includeUserData - whether to include user data or not
Returns:: heavy logical paths, i.e., logical paths with detailed node and link information
Throws:: LODNetworkException

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 information; userDataCategories - 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

Deprecated. use ...(..., int[] userDataCategories, ...)

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 ID; userDataCategories - user data categories to be included
Returns:: spatial link
Throws:: LODNetworkException

readSpatialLinks

SpatialLink[] readSpatialLinks(long[] linkIds,
                               boolean includeUserData)
                               throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

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 IDs; userDataCategories - user data categories to be included
Returns:: spatial links
Throws:: LODNetworkException

readSpatialNode

SpatialNode readSpatialNode(long nodeId,
                            boolean includeUserData)
                            throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

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 ID; userDataCategories - user data categories to be included
Returns:: spatial node
Throws:: LODNetworkException

readSpatialNodes

SpatialNode[] readSpatialNodes(long[] nodeIds,
                               boolean includeUserData)
                               throws LODNetworkException

Deprecated. use ...(..., int[] userDataCategories, ...)

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 IDs; userDataCategories - 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 level; updatedNodeIds - new and updated node IDs; deletedNodeIds - deleted node IDs; updatedLinkIds - new and updated link IDs; deletedLinkIds - deleted link IDs
Returns:: network update object
Throws:: LODNetworkException

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 level; changedNodeIds - new, updated and deleted node IDs; changedLinkIds - 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 - path; pathName - user specified path name; pathType - user specified path type
Returns:: path ID
Throws:: LODNetworkException

writePath

void writePath(LogicalPath path,
               long pathId,
               java.lang.String pathName,
               java.lang.String pathType)
               throws LODNetworkException

Stores a path in the database.

Parameters:: path - path; pathId - path ID; pathName - user specified path name; pathType - user specified path type
Throws:: LODNetworkException

writeSubPath

long writeSubPath(LogicalSubPath subPath,
                  long referencePathId,
                  java.lang.String subPathName,
                  java.lang.String subPathType)
                  throws LODNetworkException

Stores a sub-path in the database. Before calling this method, the reference path must have already been stored in the database.

Parameters:: subPath - sub-path; referencePathId - reference path ID; subPathName - user specified sub-path name; subPathType - user specified sub-path type
Returns:: sub-path ID
Throws:: LODNetworkException

writeSubPath

void writeSubPath(LogicalSubPath subPath,
                  long subPathId,
                  long referencePathId,
                  java.lang.String subPathName,
                  java.lang.String subPathType)
                  throws LODNetworkException

Stores a sub-path in the database. Before calling this method, the reference path must have already been stored in the database.

Parameters:: subPath - sub-path; subPathId - sub-path ID; referencePathId - reference path ID; subPathName - user specified sub-path name; subPathType - user specified sub-path type
Throws:: LODNetworkException

deletePath

void deletePath(long pathId)
                throws LODNetworkException

Deletes path.

Parameters:: pathId - path ID
Throws:: LODNetworkException

deletePaths

void deletePaths(long[] pathIds)
                 throws LODNetworkException

Deletes paths.

Parameters:: pathIds - path IDs
Throws:: LODNetworkException

deleteSubPath

void deleteSubPath(long subPathId)
                   throws LODNetworkException

Deletes sub-path.

Parameters:: subPathId - sub-path ID
Throws:: LODNetworkException

deleteSubPaths

void deleteSubPaths(long[] subPathIds)
                    throws LODNetworkException

Deletes sub-paths.

Parameters:: subPathIds - sub-path IDs
Throws:: LODNetworkException

readNetworkBuffer

NetworkBuffer readNetworkBuffer(long bufferId)
                                throws LODNetworkException

Reads the network buffer with the specified buffer ID.

Parameters:: bufferId - ID of the network buffer
Returns:
Throws:: LODNetworkException

writeNetworkBuffer

void writeNetworkBuffer(NetworkBuffer buffer,
                        long bufferId)
                        throws LODNetworkException

Stores the network buffer into the database.

Parameters:: buffer - network buffer to be stored; bufferId - ID of the network buffer in the database
Throws:: LODNetworkException

writeNetworkBuffer

long writeNetworkBuffer(NetworkBuffer buffer)
                        throws LODNetworkException

Stores the network buffer into the database. An ID will be automatically assigned to this network buffer.

Parameters:: buffer - network buffer to be stored
Returns:: the ID of the network buffer
Throws:: LODNetworkException

deleteNetworkBuffer

void deleteNetworkBuffer(long id)
                         throws LODNetworkException

Deletes the network buffer from the database.

Parameters:: id - ID 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

Deprecated. use generatePartitionBlobs(int linkLevel, boolean includeUserData, boolean commitForEachBlob, boolean performDeltaUpdate)

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 level; 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 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 partition; 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:: Oracle Database 11g Release 2 (11.2)

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 level; 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 partition; 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:: Oracle Database 11g Release 2 (11.2)

generatePartitionBlob

void generatePartitionBlob(int partitionId,
                           int linkLevel,
                           boolean includeUserData)
                           throws LODNetworkException

Deprecated.

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 ID; linkLevel - link level; includeUserData - 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 ID; linkLevel - link level; includeUserData - 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:: Oracle Database 11g Release 2 (11.2)

getNextTmpNodeId

long getNextTmpNodeId()

Returns the next temporary node ID.

Returns:

getNextTmpLinkId

long getNextTmpLinkId()

Returns the next temporary link ID.

Returns:

Overview

Package

Class

Tree

Deprecated

Index

Help

Oracle® Spatial Java API Reference
11g Release 2 (11.2)
E11829-02

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

oracle.spatial.network.lod Interface NetworkIO

getGlobalNetworkName

getNetworkAdaptor

setNetworkAdaptor

getNetworkMetadata

setNetworkMetadata

getUserDataIOs

setUserDataIOs

commit

rollback

isNodesExist

hasNodes

isLinksExist

hasLinks

openPartitionBlobOutputStream

updatePartitionBlobInfo

readNumberOfNodes

readNumberOfLinks

readNodeIds

readLinkIds

readLogicalNodes

readLogicalLinks

readArbitraryLogicalNodes

readArbitraryLogicalLinks

readArbitraryLogicalNode

readArbitraryLogicalLink

readLogicalNetwork

readLogicalNetwork

readLogicalNetwork

readLogicalNetwork

readLogicalPartition

readLogicalPartition

readLogicalPartition

readLogicalPartition

readLogicalPartitions

readLogicalPartitions

readLogicalPartitions

readLogicalPartitions

readUserData

readPartitionId

readPartitionIds

readNodePartitionId

readNodePartitionIds

readLinkPartitionIds

readLinkPartitionIds

readAdjacentPartitionIdsForNodes

readAdjacentPartitionIdsForLinks

readPartitionIds

readNumberOfPartitions

readNumberOfConnectedComponents

readComponentIds

readComponentId

readLogicalLink

readLogicalLink

readLogicalLinks

readLogicalLinks

readLogicalNode

readLogicalNodes

readLogicalNode

readLogicalNodes

readLogicalPath

readLogicalPaths

readLogicalPath

readLogicalPaths

readLogicalSubPath

readLogicalSubPaths

readLogicalSubPath

readLogicalSubPaths

readLogicalHeavyPath

readLogicalHeavyPaths

readLogicalHeavyPath

readLogicalHeavyPaths

readSpatialNetwork

readSpatialPartition

readSpatialPartition

readSpatialPartition

readSpatialPartition

readSpatialPartition

readSpatialPartitionMBR

readSpatialPartitionMBRs

oracle.spatial.network.lod
Interface NetworkIO