Package oracle.spatial.network.nfe.io.jdbc.service

Class JDBCAnalysisIOService

java.lang.Object

oracle.spatial.network.nfe.io.jdbc.service.JDBCAbstractIOService

oracle.spatial.network.nfe.io.jdbc.service.JDBCAnalysisIOService

All Implemented Interfaces:

NFEAnalysisIOService, NFEIOService

public class JDBCAnalysisIOService
extends JDBCAbstractIOService
implements NFEAnalysisIOService

Provides the default implementation for the analysis service.

Constructor Summary

Constructors

Constructor	Description
JDBCAnalysisIOService(NFEIOServiceProvider serviceProvider)

Method Summary

Modifier and Type	Method	Description
void	deletePath(NFEFeature nfeFeature)	Deletes feature path.
java.util.List<NFEFeature>	runNearestNeighbors(NFENearestNeighbors nearestNeighbors, boolean useCachedNetwork, NFEExpressionAnalyzer nfeExpressionAnalyzer, LODNetworkConstraint constraint)	Finds the nearest features from the start feature.
NFEFeature	runShortestPath(NFEShortestPath shortestPath, boolean useCachedNetwork, NFEExpressionAnalyzer nfeExpressionAnalyzer, LODNetworkConstraint constraint)	Finds the shortest path from the start feature to the end feature.
java.util.List<NFEFeature>	runTSP(NFETsp nfeTsp, boolean useCachedNetwork, NFEExpressionAnalyzer nfeExpressionAnalyzer, LODNetworkConstraint constraint)	Returns the traveling salesman tour covering the input features.
java.util.List<NFEFeature>	runWithinCost(NFEWithinCost withinCost, boolean useCachedNetwork, NFEExpressionAnalyzer nfeExpressionAnalyzer, LODNetworkConstraint constraint)	Finds features within the given cost from the start feature.
void	savePaths(java.util.List<NFEFeature> featureList)	Saves feature paths.

Methods inherited from class oracle.spatial.network.nfe.io.jdbc.service.JDBCAbstractIOService

close, commit, commitAndClose, getDataSource, getModel, getServiceProvider, rollback, rollbackAndClose, setDataSource, setModel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.spatial.network.nfe.io.service.NFEIOService

getDataSource, getModel, getServiceProvider, setDataSource, setModel

Constructor Detail

JDBCAnalysisIOService

public JDBCAnalysisIOService(NFEIOServiceProvider serviceProvider)

Method Detail

savePaths

public void savePaths(java.util.List<NFEFeature> featureList)
               throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Saves feature paths.

Specified by:

savePaths in interface NFEAnalysisIOService

Parameters:

featureList - list of the feature paths to save

Throws:

NFEIOException - if an NFE error occurs.

deletePath

public void deletePath(NFEFeature nfeFeature)
                throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Deletes feature path.

Specified by:

deletePath in interface NFEAnalysisIOService

Parameters:

nfeFeature - path to delete

Throws:

NFEIOException - if an NFE error occurs.

runShortestPath

public NFEFeature runShortestPath(NFEShortestPath shortestPath,
                                  boolean useCachedNetwork,
                                  NFEExpressionAnalyzer nfeExpressionAnalyzer,
                                  LODNetworkConstraint constraint)
                           throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Finds the shortest path from the start feature to the end feature. The start feature and the end feature can belong to different feature layers. Set shortestPath.setReverseDirection to true to use reverse search direction. Enable the analysis on the model before to use this function with modelService.enableAnalysisInModel.

Specified by:

runShortestPath in interface NFEAnalysisIOService

Parameters:

shortestPath - shortest path analysis data

useCachedNetwork - if true use a cached network, if false reload the needed network data

nfeExpressionAnalyzer - needed in case of customized cost, the analyzer will be used to calculate the customized cost expression

constraint - network constraint

Returns:

path feature representing the shortest path from the start feature to the end feature

Throws:

NFEIOException - if an NFE error occurs.

runNearestNeighbors

public java.util.List<NFEFeature> runNearestNeighbors(NFENearestNeighbors nearestNeighbors,
                                                      boolean useCachedNetwork,
                                                      NFEExpressionAnalyzer nfeExpressionAnalyzer,
                                                      LODNetworkConstraint constraint)
                                               throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Finds the nearest features from the start feature. The searched features will belong to the featureLayer specified in the NFENearestNeighbors object. For example if the feature layer is HOTEL and numberOfNeighbors is 5 then the analysis will find the 5 nearest hotels. Enable the analysis on the model before to use this function with modelService.enableAnalysisInModel.

Specified by:

runNearestNeighbors in interface NFEAnalysisIOService

Parameters:

nearestNeighbors - nearest neighbor analysis data

useCachedNetwork - if true use a cached network, if false reload the needed network data

nfeExpressionAnalyzer - needed in case of customized cost, the analyzer will be used to calculate the customized cost expression

constraint - network constraint

Returns:

path features representing the shortest paths from a start feature to the nearest neighbors

Throws:

NFEIOException - if an NFE error occurs.

runWithinCost

public java.util.List<NFEFeature> runWithinCost(NFEWithinCost withinCost,
                                                boolean useCachedNetwork,
                                                NFEExpressionAnalyzer nfeExpressionAnalyzer,
                                                LODNetworkConstraint constraint)
                                         throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Finds features within the given cost from the start feature. The searched features will belong to the featureLayer specified in the NFEWithinCost object. Enable the analysis on the model before to use this function with modelService.enableAnalysisInModel.

Specified by:

runWithinCost in interface NFEAnalysisIOService

Parameters:

withinCost - within cost analysis data

useCachedNetwork - if true use a cached network, if false reload the needed network data

nfeExpressionAnalyzer - needed in case of customized cost, the analyzer will be used to calculate the customized cost expression

constraint - network constraint

Returns:

path features representing the shortest paths from a start feature to the features within the given cost

Throws:

NFEIOException - if an NFE error occurs.

runTSP

public java.util.List<NFEFeature> runTSP(NFETsp nfeTsp,
                                         boolean useCachedNetwork,
                                         NFEExpressionAnalyzer nfeExpressionAnalyzer,
                                         LODNetworkConstraint constraint)
                                  throws NFEIOException

Description copied from interface: NFEAnalysisIOService

Returns the traveling salesman tour covering the input features. Enable the analysis on the model before to use this function with modelService.enableAnalysisInModel.

Specified by:

runTSP in interface NFEAnalysisIOService

Parameters:

nfeTsp - TSP analysis data

useCachedNetwork - if true use a cached network, if false reload the needed network data

nfeExpressionAnalyzer - needed in case of customized cost, the analyzer will be used to calculate the customized cost expression

constraint - network constraint

Returns:

traveling salesman tour

Throws:

NFEIOException - if an NFE error occurs.