search: keywords: ['Java API', 'OServer', 'get instance', 'getInstanceByPath']

OServer - getInstanceByPath()

This method retrieves the given instance of an OrientDB Server by its path.

Retrieving OServer Instances

In addition to starting an embedded instance of the OrientDB Server, you can also retrieve a particular OServer instance, as identified by its path. If you want to retrieve the server instance by its ID, see the getInstance() method.

Syntax

public static OServer OServer().getInstanceByPath(String iPath)
ArgumentTypeDescription
iPathjava.lang.StringDefines the sever path you want to retrieve.

Return Value

This method returns an OServer value. It provides you with an instance of the OrientDB Server running on the given path.

Example

Imagine you have OrientDB running in a distributed deployment and have an operation that you need to run on several servers in sequence. You might use a method such as this to convert a list of server paths into one of active OServer instances.

/**
 * Retrieve OServer Instances by Path 
 */
public List<OServer> fetchOServers(OServer oserver, List<String> paths){

   // Log Operation
   logger.info("Fetching OrientDB Servers");

   // Initialize Variables
   List<OServer> oservers;

   // Loop Over Server ID's
   for (int i = 0; i < paths.size(); i++){

      // Retrieve ID
      String path = path.get(i);

	  // Retrieve OServer
	  oservers.add(oserver.getInstanceByPath(path));

   }

   // Return OServer List
   return oservers;

}