Package com._1c.g5.v8.dt.internal.pm

Class ProcessManager

java.lang.Object

com._1c.g5.v8.dt.internal.pm.ProcessManager

All Implemented Interfaces:

IProcessManager

public class ProcessManager
extends Object
implements IProcessManager

An IProcessManager interface basic implementation

Method Summary

Modifier and Type	Method	Description
void	dispose()	IProcessManager.dispose() method implementation.
void	dispose(String key)	IProcessManager.dispose(String) method implementation.
void	dispose(String key, Object stub)	IProcessManager.dispose(String, Object) method implementation.
<T> ICloseableInstance<T>	getCloseableInstance(String key, Class<T> service)	IProcessManager.getCloseableInstance(String, Class) method implementation.
InputStream	getErrorsStream(String key)	IProcessManager.getErrorsStream(String) method implementation.
InputStream	getInputStream(String key)	IProcessManager.getInputStream(String) method implementation.
<T> T	getInstance(String key, Class<T> service)	A basic implementation of the IProcessManager interface's getInstance(String, Class) method
OutputStream	getOutputStream(String key)	IProcessManager.getOutputStream(String) method implementation.
ProcessBinderImpl	getProcessBinder(String key)	Returns new or exiting instance of ProcessBinder which allows bindings for the process with given key.
static ProcessManager	getProcessManager()	Returns an instance of IProcessManager.
boolean	isProcessAlive(String key)	IProcessManager#isBound(String, Class) method implementation.

Methods inherited from class java.lang.Object

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

Method Details

getProcessManager

public static ProcessManager getProcessManager()
                                        throws RemoteException,
AlreadyBoundException

Returns an instance of IProcessManager.

Throws:

RemoteException - if startup RMI registering fails

AlreadyBoundException - if IProcessRegister is already bound (for instance, if other instance of IProcessManager is created and it has chosen the same port).

PortAllocatingException - when cannot obtain free port to make RMI registry listen on

isProcessAlive

public boolean isProcessAlive(String key)

IProcessManager#isBound(String, Class) method implementation.

Specified by:

isProcessAlive in interface IProcessManager

Parameters:

key - given key

Returns:

true if the process with given key is currently running false otherwise.

getProcessBinder

public ProcessBinderImpl getProcessBinder(String key)

Description copied from interface: IProcessManager

Returns new or exiting instance of ProcessBinder which allows bindings for the process with given key. Each calling for the same key will return the same instance.

Specified by:

getProcessBinder in interface IProcessManager

Parameters:

key - given key

Returns:

new or exiting instance of ProcessBinder which allows bindings for the process with given key

See Also:

• ProcessBinder

getInstance

public <T> T getInstance(String key,
 Class<T> service)
                  throws InstantiationException,
IllegalAccessException,
IOException,
InterruptedException,
ProcessStartingTimedOut,
ProcessExitedWithErrorException

A basic implementation of the IProcessManager interface's getInstance(String, Class) method

Specified by:

getInstance in interface IProcessManager

Type Parameters:

T - - the type of the service

Parameters:

key - - the key of the process within that to run the implementation (not null)

service - - the service for that to return a stub (not null)

Returns:

a stub for given service binded to implementation instance running within a separate process (not null)

Throws:

InstantiationException - if the implementation represents an abstract class, an interface, an array class, a primitive type, or void; or if the class has no nullary constructor; or if the instantiation fails for some other reason

IllegalAccessException - if could not instantiate the implementation by it's default constructor (for instance, if the default constructor is unaccessible)

IOException - if request of starting a new process or creating an instance within a process is failed

InterruptedException - if request of starting a new process is interrupted

ProcessStartingTimedOut - if could not initially start the process, or process does not response

ProcessExitedWithErrorException - if process has not already started, and just after it started, it has exited with error code

getCloseableInstance

public <T> ICloseableInstance<T> getCloseableInstance(String key,
 Class<T> service)
                                               throws IllegalAccessException,
InstantiationException,
IOException,
InterruptedException,
ProcessStartingTimedOut,
ProcessExitedWithErrorException,
IllegalStateException

IProcessManager.getCloseableInstance(String, Class) method implementation.

Specified by:

getCloseableInstance in interface IProcessManager

Parameters:

key - a key of a process within that service implementation is running

service - a service for that instance is created

Returns:

ICloseableInstance with wrapped instance created by IProcessManager.getInstance(String, Class) method and ICloseableInstance.close() which invokes dispose(key, instance)

Throws:

IllegalAccessException - if could not instantiate the implementation by it's default constructor (for instance, if the default constructor is unaccessible)

InstantiationException - if the implementation represents an abstract class, an interface, an array class, a primitive type, or void; or if the class has no nullary constructor; or if the instantiation fails for some other reason

IOException - if request of starting a new process or creating an instance within a process is failed

InterruptedException - if request of starting a new process is interrupted

ProcessStartingTimedOut - if could not initially start the process, or process does not response

ProcessExitedWithErrorException - if process has not already started, and just after it started, it has exited with error code

IllegalStateException - if 'java.security.policy' system property is not set (System.getProperty("java.security.policy") returns null), or service for key is not bound.

See Also:

• ICloseableInstance

getOutputStream

public OutputStream getOutputStream(String key)

IProcessManager.getOutputStream(String) method implementation.

Specified by:

getOutputStream in interface IProcessManager

Parameters:

key - given process's key (not null)

Returns:

an output stream piped to the process's standard input stream, or null output stream if process's input stream is redirected, or null if process with given key has never been running

See Also:

• ProcessBinder.redirectInput(Redirect)

getInputStream

public InputStream getInputStream(String key)

IProcessManager.getInputStream(String) method implementation.

Specified by:

getInputStream in interface IProcessManager

Parameters:

key - given process's key (not null)

Returns:

an input stream piped to the process's standard output stream, or null input stream if porcess's output stream is redirected, or null if process has never been running

See Also:

• ProcessBinder.redirectOutput(Redirect)

getErrorsStream

public InputStream getErrorsStream(String key)

IProcessManager.getErrorsStream(String) method implementation.

Specified by:

getErrorsStream in interface IProcessManager

Parameters:

key - given process's key (not null)

Returns:

an input stream piped to the process's standard error stream, or null input stream if porcess's error stream is redirected, or null if process has never been running

See Also:

• ProcessBinder.redirectError(Redirect)
• ProcessBinder.mergeErrorsWithOutput()

dispose

public void dispose()

IProcessManager.dispose() method implementation.

Specified by:

dispose in interface IProcessManager

dispose

public void dispose(String key)

IProcessManager.dispose(String) method implementation.

Specified by:

dispose in interface IProcessManager

Parameters:

key - - the key for that to release resources. This key is also associated with the process to kill. (not null)

dispose

public void dispose(String key,
 Object stub)

IProcessManager.dispose(String, Object) method implementation.

Specified by:

dispose in interface IProcessManager

Parameters:

key - - the specified key for that the object associated with stub is running. (not null) Also associated with one remote process

stub - - the stub to release obtained before by IProcessManager.getInstance(String, Class) method (not null)