org.vishia.inspectorTarget

Class Inspector

java.lang.Object

org.vishia.inspectorTarget.Inspector

public class Inspector
extends java.lang.Object

This is the main class for the Inspector for Java and C. The inspector helps inspect data via reflection. It is a service. It uses an InterProcessComm implementation for communication with any client. To use the Inspector in Java you should insert the following lines on start of an Java program:

 class MyTestClass {
 
   void startRoutine() {
     //Instantiate the InterprocessComm implementation for sockets
     new org.vishia.communication.InterProcessCommFactorySocket();
     //Instance for Inspector service:
     Inspector inspc = new Inspector("UDP:0.0.0.0:60094");
     inspc.start(this);
   }
   
   void terminateRoutine() {
     Inspector.get().shutdown(this);
   }
   
   
   ......
 

• The InterProcessComm_SocketImpl instantiates a singleton referred with InterProcessCommFactory.getInstance() for socket communication. This is recommended on PC platforms.
• The start(Object) routine initiates the Inspector service with the given instance as root instance.
• The shutdown() is necessary especially if a Java frame still runs but the application with the Inspector should be terminate. It closes the communication, close the socket. If the whole Java application is end as process on the operation system, the communication is closed from the system already.
• That is all. Now the socket communication can access via UDP with the given IP and Port.

Field Summary

Fields

Modifier and Type	Field and Description
ClassContent	classContent The sub module ClassContent should be accessible from outside to offer methods of it in the application itself.
private CmdExecuter	cmdExecuter The main cmd executer.
private Comm	comm The communication class.
private static Inspector	singleton
static java.lang.String	version Version and history 2015-08-05 Hartmut new get() to get the first instance which may be a singleton.

Constructor Summary

Constructors

Constructor and Description
Inspector(java.lang.String commOwnAddr)

Method Summary

Modifier and Type	Method and Description
static Inspector	get() Returns the first instance of the Inspector in this application.
void	shutdown() Shutdown the communication, close the thread.
void	start(ClassJc rootClazz, MemSegmJc rootAddr) Start the execution.
void	start(java.lang.Object rootObj) Start the execution.

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final java.lang.String version

Version and history

• 2015-08-05 Hartmut new get() to get the first instance which may be a singleton.
• 2015-08-05 Hartmut chg classContent is public to access its methods.
• 2011-11-17 Hartmut new shutdown() to end communication thread.
• 2011-01-00 Hartmut Created from C-Sources, then re-translated to C and testet with Java2C

See Also:

Constant Field Values

singleton

private static Inspector singleton

classContent

public final ClassContent classContent

The sub module ClassContent should be accessible from outside to offer methods of it in the application itself. There are only a few public ones.

cmdExecuter

private final CmdExecuter cmdExecuter

The main cmd executer. There may be more as one CmdConsumer_ifc

comm

private final Comm comm

The communication class. @java2c=embedded Type:Comm.

Constructor Detail

Inspector

public Inspector(java.lang.String commOwnAddr)

Parameters:

commOwnAddr - forex "UDP:0.0.0.0:60078"

Method Detail

get

public static Inspector get()

Returns the first instance of the Inspector in this application. Usual only one instance is used, then it is a singleton. More as one instance is possible, then the first instance is the singleton returned here. If the Inspector is not created yet, this method returns null.

Returns:

start

public void start(java.lang.Object rootObj)

Start the execution.

start

public void start(ClassJc rootClazz,
                  MemSegmJc rootAddr)

Start the execution.

shutdown

public void shutdown()

Shutdown the communication, close the thread. This routine should be called either on shutdown of the whole system or on closing the inspector functionality. The inspector functionality can be restarted calling start(Object).