NetworkFactory (Oracle Spatial and Graph Java API Reference)

java.lang.Object
- oracle.spatial.network.NetworkFactory

```
public class NetworkFactory
extends java.lang.Object
```
This class handles network element creation for Oracle Spatial Network Data Model.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`addBidirectedLinkColumn(java.sql.Connection conn, Network network)` add a bidirected column to the network link table
`static void`	`addColumn(java.sql.Connection conn, java.lang.String tableName, java.lang.String columnName, java.lang.String columnDataType)` Add a column in a database table
`static void`	`addUserDataSchema(java.sql.Connection conn, NetworkMetadata metadata)`
`static Path`	`createComplexPath(int id, Node startNode, Node endNode, Link[] links)` Creates a complex path with the specified start node and end node
`static MDPoint[]`	`createConvexHull(JGeometry geom)` Creates a convex hull as an array of MDpoint for the specified geometry.
`static MDPoint[]`	`createConvexHull(MDPoint[] points)` Creates the convex hull as an array of MDpoint for the specified array of MDPoints.
`static MDPoint[]`	`createConvexHull(Network network)` Creates the convex hull as an array of MDpoint for the specified network.
`static Network`	`createDirectedNetwork()`
`static GeometryMetadata`	`createGeometryMetadata(java.lang.String tableName)` Deprecated.
`static GeometryMetadata`	`createGeometryMetadata(java.lang.String owner, java.lang.String tableName)` Creates a geometry metadata.
`static GeometryMetadata`	`createGeometryMetadata(java.lang.String tableName, java.lang.String geomColumnName, int srid, int noOfDims)` Deprecated.
`static GeometryMetadata`	`createGeometryMetadata(java.lang.String owner, java.lang.String tableName, java.lang.String geomColumnName, int srid, int noOfDims)` Creates a spatial geometry metadata.
`static Link`	`createLink(int id, Network network, int startNodeID, int endNodeID, double cost)` Creates a logical network link.
`static Link`	`createLink(int id, Node startNode, Node endNode, double cost)` Creates a logical network link.
`static Link`	`createLink(int id, java.lang.String name, Node startNode, Node endNode, double cost)` Creates a logical network link.
`JGeometry`	`createLinkGeometry(int srid, int noOfDims, double[] ordArray)` Returns a link geometry (a linestring JGeometry).
`static void`	`createLinkTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomType, java.lang.String geomColumnName, java.lang.String costColumnName, int noOfHierarchyLevels)` Creates an empty network link table in the database.
`static Link`	`createLogicalLink(int linkID, java.lang.String linkName, Node startNode, Node endNode, double cost)` Creates a logical link.
`static Network`	`createLogicalNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected)` Creates an empty logical network with the default naming convension: node table name = network_name + "_NODE$", link table name = network_name + "_LINK$, path table name = network_name + "_PATH$", path-link table name = network_name + "PLINK$", subPath table name = network_name + "SPATH$", all cost column name="COST".
`static Network`	`createLogicalNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, java.lang.String nodeTableName, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkCostColumn, java.lang.String pathTableName, java.lang.String pathLinkTableName)` Creates an empty logical network.
`static Network`	`createLogicalNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, java.lang.String nodeTableName, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkCostColumn, java.lang.String pathTableName, java.lang.String pathLinkTableName, java.lang.String subPathTableName)` Creates an empty logical network.
`static Node`	`createLogicalNode(int nodeID, java.lang.String nodeName)` Creates a logical node.
`static Link`	`createLRSLink(int linkID, java.lang.String linkName, Node startNode, Node endNode, double cost, int geomID, double startMeasure, double endMeasure, JGeometry geom)` Creates an LRS geometry link.
`static Network`	`createLRSNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims, java.lang.String lrsTableName, java.lang.String lrsGeomColumn)` Creates an empty spatial LRS_GEOMETRY network.
`static Network`	`createLRSNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims, java.lang.String nodeTableName, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkCostColumn, java.lang.String lrsTableName, java.lang.String lrsGeomColumn, java.lang.String pathTableName, java.lang.String pathGeomColumn, java.lang.String pathLinkTableName)` Creates an empty spatial LRS_GEOMETRY network.
`static Network`	`createLRSNetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims, java.lang.String nodeTableName, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkCostColumn, java.lang.String lrsTableName, java.lang.String lrsGeomColumn, java.lang.String pathTableName, java.lang.String pathGeomColumn, java.lang.String pathLinkTableName, java.lang.String subPathTableName, java.lang.String subPathGeomColumn)` Creates an empty spatial LRS_GEOMETRY network.
`static Node`	`createLRSNode(int nodeID, java.lang.String nodeName, int geomID, double measure, JGeometry geom)` Creates an LRS geometry node.
`static void`	`createLRSTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomColumnName)` Creates an empty network LRS table in the database.
`static MBR`	`createMBR(double[] min, double[] max)` Creates an MBR.
`static MBR`	`createMBR(JGeometry geom)` Creates an MBR of the specified geometry.
`static MDPoint`	`createMDPoint(double x)` Creates a 1D MDPoint.
`static MDPoint`	`createMDPoint(double[] pt)` Creates an MDPoint.
`static MDPoint`	`createMDPoint(double x, double y)` Creates a 2D MDPoint.
`static MDPoint`	`createMDPoint(double x, double y, double z)` Creates a 3D MDPoint.
`static Network`	`createNetwork(Network network)` Creates an empty network from the specified network (metadata).
`static void`	`createNetworkTables(java.sql.Connection conn, Network network)` Creates the network tables based on the specified network metadata.
`static Node`	`createNode(int id)` Creates a logical network node.
`static Node`	`createNode(int id, double x, double y)` Creates a spatial network node.
`static Node`	`createNode(int id, java.lang.String name)` Creates a logical network node.
`JGeometry`	`createNodeGeometry(int srid, int noOfDims, double[] ordArray)` Returns a node point geometry (JGeometry).
`static void`	`createNodeTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomType, java.lang.String geomColumnName, java.lang.String costColumnName, int noOfHierarchyLevels)` Creates an empty network node table in the database.
`static void`	`createNodeTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomType, java.lang.String geomColumnName, java.lang.String costColumnName, java.lang.String partitionColumnName, int noOfHierarchyLevels)` Creates an empty network node table in the database.
`static Network`	`createPartitionNetwork(java.sql.Connection conn, java.lang.String networkName, java.lang.String partitionNetworkName)` Returns the partition network with the partitions as nodes and the connections between partitions as links.
`static Network`	`createPartitionNetwork(Network network, java.lang.String partitionNetworkName)` Returns the partition network with the partitions as nodes and the connections between partitions as links.
`static void`	`createPartitionTable(java.sql.Connection conn, java.lang.String tableName)` Creates an empty network partition table in the database.
`static Path`	`createPath(int id, Node startNode, Node endNode, Link[] links)` Creates a path with the specified start node and the specified end node.
`static Path`	`createPath(Node startNode, Node endNode)` Creates an empty path with the specified start node and end node.
`static Path`	`createPath(Node startNode, Node endNode, Link[] links)` Creates a path with the specified start node and the specified end node.
`static void`	`createPathLinkTable(java.sql.Connection conn, java.lang.String tableName)` Creates an empty network path-link table in the database.
`static void`	`createPathTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomColumnName)` Creates an empty network path table in the database.
`static SDODimArray`	`createSDODimArray(boolean isGeodetic, double lowerBound, double upperBound, double tolerance)` Creates a java 2D SDO_DIM_ARRAY.
`static SDODimArray`	`createSDODimArray(java.lang.String[] dimNames, double[] lowerBounds, double[] upperBounds, double[] tolerances)` Creates a java SDO_DIM_ARRAY.
`static Link`	`createSDOLink(int linkID, java.lang.String linkName, Node startNode, Node endNode, double cost, double[] ords, int dimNo, int srid)` Creates an SDO geometry link.
`static Link`	`createSDOLink(int linkID, java.lang.String linkName, Node startNode, Node endNode, double cost, JGeometry geom)` Creates an SDO geometry link.
`static Network`	`createSDONetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims)` Creates an empty spatial SDO_GEOMETRY network with the default naming convension: node table name = network_name + "_NODE$", link table name = network_name + "_LINK$, path table name = network_name + "_PATH$", path-link table name = network_name + "PLINK$", subpath table name = network_name + "_SPATH$", all geometry column
`static Network`	`createSDONetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims, java.lang.String nodeTableName, java.lang.String nodeGeomColumn, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkGeomColumn, java.lang.String linkCostColumn, java.lang.String pathTableName, java.lang.String pathGeomColumn, java.lang.String pathLinkTableName)` Creates an empty spatial SDO_GEOMETRY network.
`static Network`	`createSDONetwork(java.lang.String networkName, int noOfHierarchyLevels, boolean isDirected, int srid, int noOfDims, java.lang.String nodeTableName, java.lang.String nodeGeomColumn, java.lang.String nodeCostColumn, java.lang.String linkTableName, java.lang.String linkGeomColumn, java.lang.String linkCostColumn, java.lang.String pathTableName, java.lang.String pathGeomColumn, java.lang.String pathLinkTableName, java.lang.String subPathTableName, java.lang.String subPathGeomColumn)` Creates an empty spatial SDO_GEOMETRY network.
`static Node`	`createSDONode(int nodeID, java.lang.String nodeName, double x, double y)` Creates a spatial node (SDO_GEOMETRY with SRID = 0).
`static Node`	`createSDONode(int nodeID, java.lang.String nodeName, double x, double y, int srid)` Creates a spatial node (SDO_GEOMETRY).
`static Path`	`createSimplePath(int id, Node startNode, Node endNode, Link[] links)` Creates a simple path with the specified start node and end node.
`static SubPath`	`createSubPath(int id, Path referencePath, int startLinkIndex, double startPercentage, int endLinkIndex, double endPercentage)` Creates a sub path
`static SubPath`	`createSubPath(Path referencePath, int startLinkIndex, double startPercentage, int endLinkIndex, double endPercentage)` Creates a sub path
`static void`	`createSubPathTable(java.sql.Connection conn, java.lang.String tableName, java.lang.String geomColumnName)` Creates an empty network subpath table in the database.
`static Tree`	`createTree(TreeNode root)` Creates a tree.
`static Tree`	`createTree(TreeNode root, boolean forward)` Creates a tree.
`static TreeLink`	`createTreeLink(Link link)` Creates a tree link containing a regular network link
`static TreeLink`	`createTreeLink(Link link, double startPercentage, double endPercentage)` Creates a tree link containing a partial link
`static TreeNode`	`createTreeNode(Link link, double percentage)` Creates a tree node containg a node on a link
`static TreeNode`	`createTreeNode(Node node)` Creates a tree node containing a regular node

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createDirectedNetwork

public static Network createDirectedNetwork()

createNetwork
```
public static Network createNetwork(Network network)
```
Creates an empty network from the specified network (metadata).

Parameters:

network - the specified network

createNode
```
public static Node createNode(int id)
```
Creates a logical network node.

Parameters:

id - the node ID

createNode

public static Node createNode(int id,
                              java.lang.String name)

Creates a logical network node.

Parameters:: id - the node ID; name - node Name

createNode

public static Node createNode(int id,
                              double x,
                              double y)

Creates a spatial network node.

Parameters:: id - the node ID; x - the x ordinate; y - the y ordinate

createLink

public static Link createLink(int id,
                              java.lang.String name,
                              Node startNode,
                              Node endNode,
                              double cost)

Creates a logical network link.

Parameters:: id - the link ID; name - the link name; startNode - the start node; endNode - the end node; cost - the link cost

createLink

public static Link createLink(int id,
                              Node startNode,
                              Node endNode,
                              double cost)

Creates a logical network link.

Parameters:: id - the link ID; startNode - the start node; endNode - the end node; cost - the link cost

createLink

public static Link createLink(int id,
                              Network network,
                              int startNodeID,
                              int endNodeID,
                              double cost)
                       throws NetworkDataException

Creates a logical network link.

Parameters:: id - the link ID; network - the specified network; startNodeID - the start node ID; endNodeID - the end node ID; cost - the link cost
Throws:: NetworkDataException

createPath
```
public static Path createPath(Node startNode,
                              Node endNode)
```
Creates an empty path with the specified start node and end node.

Parameters:

startNode - the start node

endNode - the end node

createSimplePath

public static Path createSimplePath(int id,
                                    Node startNode,
                                    Node endNode,
                                    Link[] links)
                             throws NetworkDataException

Creates a simple path with the specified start node and end node.

Parameters:: id - the path ID; startNode - the start node; endNode - the end node; links - the array of the path links
Throws:: NetworkDataException

createComplexPath

public static Path createComplexPath(int id,
                                     Node startNode,
                                     Node endNode,
                                     Link[] links)
                              throws NetworkDataException

Creates a complex path with the specified start node and end node

Parameters:: id - the path ID; startNode - the start node; endNode - the end node; links - the array of the path links
Throws:: NetworkDataException

createPath

public static Path createPath(Node startNode,
                              Node endNode,
                              Link[] links)

Creates a path with the specified start node and the specified end node.

Parameters:: startNode - the start node; endNode - the end node; links - the array of the path links

createPath

public static Path createPath(int id,
                              Node startNode,
                              Node endNode,
                              Link[] links)

Creates a path with the specified start node and the specified end node.

Parameters:: id - the path ID; startNode - the start node; endNode - the end node; links - the array of the path links

createMBR
```
public static MBR createMBR(double[] min,
                            double[] max)
```
Creates an MBR.

Parameters:

min - the ordinates of low point

max - the ordinates of high point

createMBR
```
public static MBR createMBR(JGeometry geom)
```
Creates an MBR of the specified geometry.

Parameters:

geom - the specified geometry

createMDPoint
```
public static MDPoint createMDPoint(double[] pt)
```
Creates an MDPoint.

Parameters:

pt - the point ordinates

createMDPoint
```
public static MDPoint createMDPoint(double x)
```
Creates a 1D MDPoint.

Parameters:

x - the x ordinate

createMDPoint

public static MDPoint createMDPoint(double x,
                                    double y)

Creates a 2D MDPoint.

Parameters:: x - the x ordinate; y - the y ordinate

createMDPoint

public static MDPoint createMDPoint(double x,
                                    double y,
                                    double z)

Creates a 3D MDPoint.

Parameters:: x - the x ordinate; y - the y ordinate; z - the z ordinate

createConvexHull
```
public static MDPoint[] createConvexHull(JGeometry geom)
```
Creates a convex hull as an array of MDpoint for the specified geometry.

Parameters:

geom - the specified geometry

createConvexHull
```
public static MDPoint[] createConvexHull(MDPoint[] points)
```
Creates the convex hull as an array of MDpoint for the specified array of MDPoints.

Parameters:

points -

createConvexHull
```
public static MDPoint[] createConvexHull(Network network)
```
Creates the convex hull as an array of MDpoint for the specified network.

Parameters:

network - network from which the convex hull is to be created

createGeometryMetadata

public static GeometryMetadata createGeometryMetadata(java.lang.String tableName)

Deprecated.

Creates a geometry metadata.

createGeometryMetadata

public static GeometryMetadata createGeometryMetadata(java.lang.String owner,
                                                      java.lang.String tableName)

Creates a geometry metadata.

createGeometryMetadata

public static GeometryMetadata createGeometryMetadata(java.lang.String tableName,
                                                      java.lang.String geomColumnName,
                                                      int srid,
                                                      int noOfDims)

Deprecated.

Creates a spatial geometry metadata.

Parameters:: tableName - the geometry table Name; geomColumnName - the geometry column name; srid - the SRID; noOfDims - the number of dimensions

createGeometryMetadata

public static GeometryMetadata createGeometryMetadata(java.lang.String owner,
                                                      java.lang.String tableName,
                                                      java.lang.String geomColumnName,
                                                      int srid,
                                                      int noOfDims)

Creates a spatial geometry metadata.

Parameters:: tableName - the geometry table Name; geomColumnName - the geometry column name; srid - the SRID; noOfDims - the number of dimensions

createLogicalNetwork

public static Network createLogicalNetwork(java.lang.String networkName,
                                           int noOfHierarchyLevels,
                                           boolean isDirected,
                                           java.lang.String nodeTableName,
                                           java.lang.String nodeCostColumn,
                                           java.lang.String linkTableName,
                                           java.lang.String linkCostColumn,
                                           java.lang.String pathTableName,
                                           java.lang.String pathLinkTableName)

Creates an empty logical network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; nodeTableName - the node table name name; nodeCostColumn - the node cost column; linkTableName - the link table name; linkCostColumn - the link cost column name; pathTableName - the path table name; pathLinkTableName - the path-link table name

createLogicalNetwork

public static Network createLogicalNetwork(java.lang.String networkName,
                                           int noOfHierarchyLevels,
                                           boolean isDirected,
                                           java.lang.String nodeTableName,
                                           java.lang.String nodeCostColumn,
                                           java.lang.String linkTableName,
                                           java.lang.String linkCostColumn,
                                           java.lang.String pathTableName,
                                           java.lang.String pathLinkTableName,
                                           java.lang.String subPathTableName)

Creates an empty logical network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; nodeTableName - the node table name name; nodeCostColumn - the node cost column; linkTableName - the link table name; linkCostColumn - the link cost column name; pathTableName - the path table name; pathLinkTableName - the path-link table name; isComplex - is this network a complex network that referes to other networks

createLogicalNetwork
```
public static Network createLogicalNetwork(java.lang.String networkName,
                                           int noOfHierarchyLevels,
                                           boolean isDirected)
```
Creates an empty logical network with the default naming convension: node table name = network_name + "_NODE$", link table name = network_name + "_LINK$, path table name = network_name + "_PATH$", path-link table name = network_name + "PLINK$", subPath table name = network_name + "SPATH$", all cost column name="COST".

Parameters:

networkName - the network name

noOfHierarchyLevels - the number of hierarchy levels

isDirected - is the network directed?

createSDONetwork

public static Network createSDONetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims,
                                       java.lang.String nodeTableName,
                                       java.lang.String nodeGeomColumn,
                                       java.lang.String nodeCostColumn,
                                       java.lang.String linkTableName,
                                       java.lang.String linkGeomColumn,
                                       java.lang.String linkCostColumn,
                                       java.lang.String pathTableName,
                                       java.lang.String pathGeomColumn,
                                       java.lang.String pathLinkTableName)

Creates an empty spatial SDO_GEOMETRY network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; srid - the SRID; noOfDims - the number of dimensions; nodeTableName - the node table name; nodeGeomColumn - the node geometry column name; nodeCostColumn - the node cost column name; linkTableName - the link table name; linkGeomColumn - the link geometry column name; linkCostColumn - the link cost column name; pathTableName - the path table name; pathGeomColumn - the path geometry column name; pathLinkTableName - the path link table name

createSDONetwork

public static Network createSDONetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims,
                                       java.lang.String nodeTableName,
                                       java.lang.String nodeGeomColumn,
                                       java.lang.String nodeCostColumn,
                                       java.lang.String linkTableName,
                                       java.lang.String linkGeomColumn,
                                       java.lang.String linkCostColumn,
                                       java.lang.String pathTableName,
                                       java.lang.String pathGeomColumn,
                                       java.lang.String pathLinkTableName,
                                       java.lang.String subPathTableName,
                                       java.lang.String subPathGeomColumn)

Creates an empty spatial SDO_GEOMETRY network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; srid - the SRID; noOfDims - the number of dimensions; nodeTableName - the node table name; nodeGeomColumn - the node geometry column name; nodeCostColumn - the node cost column name; linkTableName - the link table name; linkGeomColumn - the link geometry column name; linkCostColumn - the link cost column name; pathTableName - the path table name; pathGeomColumn - the path geometry column name; pathLinkTableName - the path link table name; subPathTableName - the subpath table name; subPathGeomColumn - the subpath geometry column name

createSDONetwork
```
public static Network createSDONetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims)
```
Creates an empty spatial SDO_GEOMETRY network with the default naming convension: node table name = network_name + "_NODE$", link table name = network_name + "_LINK$, path table name = network_name + "_PATH$", path-link table name = network_name + "PLINK$", subpath table name = network_name + "_SPATH$", all geometry column name="GEOMETRY" and all cost column

Parameters:

networkName - the network name

noOfHierarchyLevels - the number of hierarchy levels

isDirected - is the network directed?

srid - the SRID

noOfDims - the number of dimensions

createLRSNetwork

public static Network createLRSNetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims,
                                       java.lang.String nodeTableName,
                                       java.lang.String nodeCostColumn,
                                       java.lang.String linkTableName,
                                       java.lang.String linkCostColumn,
                                       java.lang.String lrsTableName,
                                       java.lang.String lrsGeomColumn,
                                       java.lang.String pathTableName,
                                       java.lang.String pathGeomColumn,
                                       java.lang.String pathLinkTableName,
                                       java.lang.String subPathTableName,
                                       java.lang.String subPathGeomColumn)

Creates an empty spatial LRS_GEOMETRY network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; srid - the SRID; noOfDims - the number of dimensions; nodeTableName - the node table name; nodeCostColumn - the node cost column name; linkTableName - the link table name; linkCostColumn - the link cost column name; lrsTableName - the LRS table name; lrsGeomColumn - the LRS geometry column name; pathTableName - the path table name; pathGeomColumn - the path geometry column; pathLinkTableName - the path link table name; subPathTableName - the path table name; subPathGeomColumn - the path geometry column networks

createLRSNetwork

public static Network createLRSNetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims,
                                       java.lang.String nodeTableName,
                                       java.lang.String nodeCostColumn,
                                       java.lang.String linkTableName,
                                       java.lang.String linkCostColumn,
                                       java.lang.String lrsTableName,
                                       java.lang.String lrsGeomColumn,
                                       java.lang.String pathTableName,
                                       java.lang.String pathGeomColumn,
                                       java.lang.String pathLinkTableName)

Creates an empty spatial LRS_GEOMETRY network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; srid - the SRID; noOfDims - the number of dimensions; nodeTableName - the node table name; nodeCostColumn - the node cost column name; linkTableName - the link table name; linkCostColumn - the link cost column name; lrsTableName - the LRS table name; lrsGeomColumn - the LRS geometry column name; pathTableName - the path table name; pathGeomColumn - the path geometry column; pathLinkTableName - the path link table name

createLRSNetwork

public static Network createLRSNetwork(java.lang.String networkName,
                                       int noOfHierarchyLevels,
                                       boolean isDirected,
                                       int srid,
                                       int noOfDims,
                                       java.lang.String lrsTableName,
                                       java.lang.String lrsGeomColumn)

Creates an empty spatial LRS_GEOMETRY network.

Parameters:: networkName - the network name; noOfHierarchyLevels - the number of hierarchy levels; isDirected - is the network directed?; srid - the SRID; noOfDims - the number of dimensions; lrsTableName - the LRS table name; lrsGeomColumn - the LRS geometry column name

createNodeTable

public static void createNodeTable(java.sql.Connection conn,
                                   java.lang.String tableName,
                                   java.lang.String geomType,
                                   java.lang.String geomColumnName,
                                   java.lang.String costColumnName,
                                   java.lang.String partitionColumnName,
                                   int noOfHierarchyLevels)
                            throws java.sql.SQLException

Creates an empty network node table in the database.

Parameters:: conn - the database connection; tableName - the node table name; geomType - the geometry type: (null | "SDO_GEOMETRY" |"LRS_GEOMETRY" | "TOPO_GEOMETRY"; geomColumnName - the geometry column name; costColumnName - the node cost column; partitionColumnName - the node partition column name; noOfHierarchyLevels - the number of hierarchy levels
Throws:: java.sql.SQLException

createNodeTable

public static void createNodeTable(java.sql.Connection conn,
                                   java.lang.String tableName,
                                   java.lang.String geomType,
                                   java.lang.String geomColumnName,
                                   java.lang.String costColumnName,
                                   int noOfHierarchyLevels)
                            throws java.sql.SQLException

Creates an empty network node table in the database.

Parameters:: conn - the database connection; tableName - the node table name; geomType - the geometry type: (null | "SDO_GEOMETRY" |"LRS_GEOMETRY" | "TOPO_GEOMETRY"; geomColumnName - the geometry column name; costColumnName - the node cost column; noOfHierarchyLevels - the number of hierarchy levels
Throws:: java.sql.SQLException

createLinkTable

public static void createLinkTable(java.sql.Connection conn,
                                   java.lang.String tableName,
                                   java.lang.String geomType,
                                   java.lang.String geomColumnName,
                                   java.lang.String costColumnName,
                                   int noOfHierarchyLevels)
                            throws java.sql.SQLException

Creates an empty network link table in the database.

Parameters:: conn - the database connection; tableName - the link table name; geomType - geometry type: (null | "SDO_GEOMETRY" |"LRS_GEOMETRY" | "TOPO_GEOMETRY"; geomColumnName - the geometry column name; costColumnName - the link cost column name; noOfHierarchyLevels - the number of hierarchy levels
Throws:: java.sql.SQLException

createLRSTable

public static void createLRSTable(java.sql.Connection conn,
                                  java.lang.String tableName,
                                  java.lang.String geomColumnName)
                           throws java.sql.SQLException

Creates an empty network LRS table in the database.

Parameters:: conn - the database connection; tableName - the LRS table name; geomColumnName - the LRS geometry column name
Throws:: java.sql.SQLException

createPathTable

public static void createPathTable(java.sql.Connection conn,
                                   java.lang.String tableName,
                                   java.lang.String geomColumnName)
                            throws java.sql.SQLException

Creates an empty network path table in the database.

Parameters:: conn - the database connection; tableName - the path table name; geomColumnName - the path geometry column name
Throws:: java.sql.SQLException

createSubPathTable

public static void createSubPathTable(java.sql.Connection conn,
                                      java.lang.String tableName,
                                      java.lang.String geomColumnName)
                               throws java.sql.SQLException

Creates an empty network subpath table in the database.

Parameters:: conn - the database connection; tableName - the subpath table name; geomColumnName - the subpath geometry column name
Throws:: java.sql.SQLException

createPathLinkTable

public static void createPathLinkTable(java.sql.Connection conn,
                                       java.lang.String tableName)
                                throws java.sql.SQLException

Creates an empty network path-link table in the database.

Parameters:: conn - the database connection; tableName - the path-link table name
Throws:: java.sql.SQLException

createPartitionTable

public static void createPartitionTable(java.sql.Connection conn,
                                        java.lang.String tableName)
                                 throws java.sql.SQLException

Creates an empty network partition table in the database.

Parameters:: conn - the database connection; tableName - the partition table name
Throws:: java.sql.SQLException

createLogicalNode

public static Node createLogicalNode(int nodeID,
                                     java.lang.String nodeName)

Creates a logical node.

Parameters:: nodeID - the node ID; nodeName - the node name

createSDONode

public static Node createSDONode(int nodeID,
                                 java.lang.String nodeName,
                                 double x,
                                 double y,
                                 int srid)

Creates a spatial node (SDO_GEOMETRY).

Parameters:: nodeID - the node ID; nodeName - the node name; x - the x ordiaate; y - the y ordinate; srid - SRID for the node geometry

createSDONode

public static Node createSDONode(int nodeID,
                                 java.lang.String nodeName,
                                 double x,
                                 double y)

Creates a spatial node (SDO_GEOMETRY with SRID = 0).

Parameters:: nodeID - the node ID; nodeName - the node name; x - the x ordiaate; y - the y ordinate

createLRSNode

public static Node createLRSNode(int nodeID,
                                 java.lang.String nodeName,
                                 int geomID,
                                 double measure,
                                 JGeometry geom)

Creates an LRS geometry node.

Parameters:: nodeID - the node ID; nodeName - the node name; geomID - the LRS geometry ID; measure - the LRS node measure; geom - the node geometry

createLogicalLink

public static Link createLogicalLink(int linkID,
                                     java.lang.String linkName,
                                     Node startNode,
                                     Node endNode,
                                     double cost)

Creates a logical link.

Parameters:: linkID - the link ID; linkName - the link name; startNode - the start node; endNode - the end node; cost - the link cost

createSDOLink

public static Link createSDOLink(int linkID,
                                 java.lang.String linkName,
                                 Node startNode,
                                 Node endNode,
                                 double cost,
                                 double[] ords,
                                 int dimNo,
                                 int srid)

Creates an SDO geometry link.

Parameters:: linkID - the link ID; linkName - the link name; startNode - the start node; endNode - the end node; cost - the link cost; ords - the geometry odrinates; dimNo - the number of dimensions; srid - the SRID

createSDOLink

public static Link createSDOLink(int linkID,
                                 java.lang.String linkName,
                                 Node startNode,
                                 Node endNode,
                                 double cost,
                                 JGeometry geom)

Creates an SDO geometry link.

Parameters:: linkID - the link ID; linkName - the link name; startNode - the start node; endNode - the end node; cost - the link cost; geom - the link geometry

createLRSLink

public static Link createLRSLink(int linkID,
                                 java.lang.String linkName,
                                 Node startNode,
                                 Node endNode,
                                 double cost,
                                 int geomID,
                                 double startMeasure,
                                 double endMeasure,
                                 JGeometry geom)

Creates an LRS geometry link.

Parameters:: linkID - the link ID; linkName - the link name; startNode - the start node; endNode - the end node; cost - the link cost; geom - the link geometry; geomID - the LRS geometry ID; startMeasure - the LRS start measure; endMeasure - the LRS end measure

createNetworkTables

public static void createNetworkTables(java.sql.Connection conn,
                                       Network network)
                                throws java.sql.SQLException,
                                       NetworkDataException

Creates the network tables based on the specified network metadata. The following tables will be created: node table, link table, path table and path-link table (if specified)

Parameters:: conn - the database connection; network - the specified network
Throws:: java.sql.SQLException; NetworkDataException

createSDODimArray

public static SDODimArray createSDODimArray(java.lang.String[] dimNames,
                                            double[] lowerBounds,
                                            double[] upperBounds,
                                            double[] tolerances)

Creates a java SDO_DIM_ARRAY.

Parameters:: dimNames - the dimension names; lowerBounds - the lower bounds; upperBounds - the upper bounds; tolerances - the tolerances

createSDODimArray

public static SDODimArray createSDODimArray(boolean isGeodetic,
                                            double lowerBound,
                                            double upperBound,
                                            double tolerance)

Creates a java 2D SDO_DIM_ARRAY.

Parameters:: isGeodetic - is it in a geodetic coordinate (lat., lon.)?; lowerBound - the lower bound; upperBound - the upper bound; tolerance - the tolerance

createNodeGeometry
```
public JGeometry createNodeGeometry(int srid,
                                    int noOfDims,
                                    double[] ordArray)
```
Returns a node point geometry (JGeometry).

Parameters:

srid - the SRID

noOfDims - the number of dimensions

ordArray - the ordinate array of the point geometry

createLinkGeometry
```
public JGeometry createLinkGeometry(int srid,
                                    int noOfDims,
                                    double[] ordArray)
```
Returns a link geometry (a linestring JGeometry).

Parameters:

srid - the SRID

noOfDims - the number of the dimensions

ordArray - the ordinate array of the link geometry(x1,y1,....xn,yn)

createPartitionNetwork
```
public static Network createPartitionNetwork(java.sql.Connection conn,
                                             java.lang.String networkName,
                                             java.lang.String partitionNetworkName)
                                      throws java.sql.SQLException,
                                             NetworkDataException
```
Returns the partition network with the partitions as nodes and the connections between partitions as links. The partition network represents the connection relationship between the partitions of the specified partitioned network

Parameters:

conn - the database connection

networkName - the network name

partitionNetworkName - the resulting partition network name

Throws:

java.sql.SQLException

NetworkDataException

createPartitionNetwork
```
public static Network createPartitionNetwork(Network network,
                                             java.lang.String partitionNetworkName)
                                      throws NetworkDataException
```
Returns the partition network with the partitions as nodes and the connections between partitions as links. The partition network represents the connection relationship between the partitions of the specified partitioned network

Parameters:

network - the network name

partitionNetworkName - the resulting partition network name

Throws:

NetworkDataException

addColumn

public static void addColumn(java.sql.Connection conn,
                             java.lang.String tableName,
                             java.lang.String columnName,
                             java.lang.String columnDataType)
                      throws java.sql.SQLException,
                             NetworkDataException

Add a column in a database table

Parameters:: conn - database connection; tableName - table name; columnName - column name to be added; columnDataType - data type for the column
Throws:: java.sql.SQLException; NetworkDataException

addBidirectedLinkColumn

public static void addBidirectedLinkColumn(java.sql.Connection conn,
                                           Network network)
                                    throws java.sql.SQLException,
                                           NetworkDataException

add a bidirected column to the network link table

Parameters:: conn - database connection; network - network object
Throws:: java.sql.SQLException; NetworkDataException

addUserDataSchema

public static void addUserDataSchema(java.sql.Connection conn,
                                     NetworkMetadata metadata)
                              throws java.sql.SQLException,
                                     NetworkDataException

Throws:: java.sql.SQLException; NetworkDataException

createSubPath
```
public static SubPath createSubPath(Path referencePath,
                                    int startLinkIndex,
                                    double startPercentage,
                                    int endLinkIndex,
                                    double endPercentage)
                             throws NetworkDataException
```
Creates a sub path

Parameters:

referencePath - reference path for the sub path

startLinkIndex - start link index of the sub path [0,noOfLinks-1]

startPercentage - end link index of the sub path [0,noOfLinks-1]

endLinkIndex - start percentage of the sub path [0,1]

endPercentage - end percentage of the sub path [0,1]

Returns:

SubPath

Throws:

NetworkDataException

createSubPath

public static SubPath createSubPath(int id,
                                    Path referencePath,
                                    int startLinkIndex,
                                    double startPercentage,
                                    int endLinkIndex,
                                    double endPercentage)
                             throws NetworkDataException

Creates a sub path

Parameters:: id - subpath ID; referencePath - reference path for the sub path; startLinkIndex - start link index of the sub path [0,noOfLinks-1]; startPercentage - end link index of the sub path [0,noOfLinks-1]; endLinkIndex - start percentage of the sub path [0,1]; endPercentage - end percentage of the sub path [0,1]
Returns:: SubPath
Throws:: NetworkDataException

createTree
```
public static Tree createTree(TreeNode root,
                              boolean forward)
```
Creates a tree. The tree nodes of a tree can either contain a regular node or a node on a link. The tree links of a tree can contain either a regular link or a partial link. A node on a link is defined by a link and a percentage information. A partial link is defined by a link , a start percentage and an end percentage.

Parameters:

root - root node of the tree

forward - true if the traverse direction is forward (starting from root), false backward

Returns:

Tree

createTree
```
public static Tree createTree(TreeNode root)
```
Creates a tree. The tree nodes of a tree can either contain a regular node or a node on a link. The tree links of a tree can contain either a regular link or a partial link. A node on a link is defined by a link and a percentage information. A partial link is defined by a link , a start percentage and an end percentage. The traverse direction is forward.

Parameters:

root - root node of the tree

Returns:

Tree

createTreeNode
```
public static TreeNode createTreeNode(Node node)
```
Creates a tree node containing a regular node

Parameters:

node - a network node

Returns:

TREENode

createTreeNode
```
public static TreeNode createTreeNode(Link link,
                                      double percentage)
                               throws NetworkDataException
```
Creates a tree node containg a node on a link

Parameters:

link - given network link

percentage - percentage information (between 0 and 1)

Returns:

TreeNode

Throws:

NetworkDataException

createTreeLink
```
public static TreeLink createTreeLink(Link link)
```
Creates a tree link containing a regular network link

Parameters:

link - network link

Returns:

TreeLink

createTreeLink
```
public static TreeLink createTreeLink(Link link,
                                      double startPercentage,
                                      double endPercentage)
                               throws NetworkDataException
```
Creates a tree link containing a partial link

Parameters:

link - the given network link

startPercentage - start percentage of the partial link

endPercentage - end percentage of the partial link

Returns:

TreeLink

Throws:

NetworkDataException

Class NetworkFactory

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createDirectedNetwork

createNetwork

createNode

createNode

createNode

createLink

createLink

createLink

createPath

createSimplePath

createComplexPath

createPath

createPath

createMBR

createMBR

createMDPoint

createMDPoint

createMDPoint

createMDPoint

createConvexHull

createConvexHull

createConvexHull

createGeometryMetadata

createGeometryMetadata

createGeometryMetadata

createGeometryMetadata

createLogicalNetwork

createLogicalNetwork

createLogicalNetwork

createSDONetwork

createSDONetwork

createSDONetwork

createLRSNetwork

createLRSNetwork

createLRSNetwork

createNodeTable

createNodeTable

createLinkTable

createLRSTable

createPathTable

createSubPathTable

createPathLinkTable

createPartitionTable

createLogicalNode

createSDONode

createSDONode

createLRSNode

createLogicalLink

createSDOLink

createSDOLink

createLRSLink

createNetworkTables

createSDODimArray

createSDODimArray

createNodeGeometry

createLinkGeometry

createPartitionNetwork

createPartitionNetwork

addColumn

addBidirectedLinkColumn

addUserDataSchema

createSubPath

createSubPath

createTree

createTree

createTreeNode

createTreeNode

createTreeLink

createTreeLink