com.dpsframework.util

Class PsLauncher

java.lang.Object

com.dpsframework.util.PsLauncher

public class PsLauncher
extends java.lang.Object

It analyzes and prepares JADE Boot launching about agents and collections. It was programmed as an operating system Bash-script spaghetti-code.

 For help, type: 
 
  $ >_  java launcher 
 
  Usage   : java launcher [toolName] [server] [name] [engine-model] [port]
 
  Others. : [-h |--help]  Full help
 
  Examples: java launcher platform
            java launcher platform     192.168.56.22    1077
            java launcher all-nodes    localhost
            java launcher node         localhost Yarvis CLIPS
            java launcher stage-node   localhost Yarvis jess 4455
            java launcher monitor      localhost H202
            java launcher board        
            java launcher dummy        
            java launcher test         localhost Pluto 4455
            etc...
 
 -------------------------------------
 

Since:

2018-07-22, update at: 2018-07-15

Version:

1.7 (Build.1814)

Author:

Francisco J. Aguayo (Leon University / IEEE Power & Energy Systems Society Member)

Property Summary

Properties

Type	Property and Description
private static java.util.HashMap<java.lang.String,java.lang.String>	loadFramework Added the framework.properties "launcher-artifacts" keys on artifacts-by-classes HashMap variable.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.HashMap<java.lang.String,java.lang.String>	artifacts_by_classes
private static java.util.HashMap<java.lang.Integer,java.lang.String>	errorLevels
private static int	level0
private static int	level1
private static int	level2
private static java.lang.String	toolName

Constructor Summary

Constructors

Constructor and Description
PsLauncher()

Method Summary

Methods

Modifier and Type	Method and Description
private static void	getInfoOfBooting(java.lang.String[] localArgs2) The real launched command-line.
private static java.lang.String	getJadeListOfInstances(java.lang.String path, java.lang.String clazz, java.lang.String param) List of available agents instances on /path/ for this kind of toolName.
private static java.util.Properties	getPropertyFile(java.lang.String fileName) A framework.properties file reader/loader.
private static java.lang.String	getTheHost(java.lang.String _theHost) Return the correct IP-Address to host-name parameter.
private static java.lang.String	i18n(java.lang.String s) Local version of i18n method.
private static boolean	isJADESocketFree(java.lang.String _host, int _port) Free-use socket test.
private static java.util.HashMap<java.lang.String,java.lang.String>	loadFrameworkProperty() Added the framework.properties "launcher-artifacts" keys on artifacts-by-classes HashMap variable.
static void	main(java.lang.String[] args) The 'java launcher' command-line tool.
private static java.lang.String[]	setJADEBootParameters(java.lang.String _host, int _port, java.lang.String _sport, java.lang.String _agentName, java.lang.String _agentClazz, java.lang.String agentParams) A JADE Boot-sentence composer.
private static void	sysLogger(java.lang.Object _errorDesc, java.lang.String _description) Local version with two parameters of sysLogger method.
private static void	sysLogger(java.lang.Object _errorDesc, java.lang.String _description, java.lang.String _cause) Local version of sysLogger method.
private static boolean	testCLASSPATH(java.lang.String _clazz) Local version of testCLASSPATH method.

Methods inherited from class java.lang.Object

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

Property Detail

loadFramework

Added the framework.properties "launcher-artifacts" keys on artifacts-by-classes HashMap variable.

Returns:

HashMap with framework.properties file assigned to.

Field Detail

artifacts_by_classes

private static final java.util.HashMap<java.lang.String,java.lang.String> artifacts_by_classes

level0

private static final int level0

See Also:

Constant Field Values

level1

private static final int level1

See Also:

Constant Field Values

level2

private static final int level2

See Also:

Constant Field Values

toolName

private static final java.lang.String toolName

See Also:

Constant Field Values

errorLevels

private static final java.util.HashMap<java.lang.Integer,java.lang.String> errorLevels

Constructor Detail

PsLauncher

public PsLauncher()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

The 'java launcher' command-line tool.

Parameters:

args - Usually, [toolName-name] [host] [agent-name] [technology] [port]

Throws:

java.io.IOException - When file framework.properties is not found.

sysLogger

private static void sysLogger(java.lang.Object _errorDesc,
             java.lang.String _description,
             java.lang.String _cause)

Local version of sysLogger method.

Parameters:

_errorDesc - Level error description or String level error description.

_description - A description about the detected error.

_cause - Error cause of.

sysLogger

private static void sysLogger(java.lang.Object _errorDesc,
             java.lang.String _description)

Local version with two parameters of sysLogger method.

Parameters:

_errorDesc - Level error description.

_description - Error description.

i18n

private static java.lang.String i18n(java.lang.String s)

Local version of i18n method.

Parameters:

s - Resource Key on dpsnode_messages.properties.

Returns:

Key resource value.

testCLASSPATH

private static boolean testCLASSPATH(java.lang.String _clazz)

Local version of testCLASSPATH method.

Parameters:

_clazz - Name of class to test.

Returns:

true If class is on CLASSPATH.

isJADESocketFree

private static boolean isJADESocketFree(java.lang.String _host,
                       int _port)

Free-use socket test.

Parameters:

_host - DNS name or IP Address.

_port - Integer number of port to test.

Returns:

true If socket number is free in that machine.

setJADEBootParameters

private static java.lang.String[] setJADEBootParameters(java.lang.String _host,
                                       int _port,
                                       java.lang.String _sport,
                                       java.lang.String _agentName,
                                       java.lang.String _agentClazz,
                                       java.lang.String agentParams)

A JADE Boot-sentence composer.

Parameters:

_host - DNS name or IP Address.

_port - Integer number of port to test.

_sport - The number of port as String.

_agentName - Name of agent in platform.

_agentClazz - Name of class from that agent.

agentParams - Anothers parameters.

Returns:

The boot JADE sentences.

getPropertyFile

private static java.util.Properties getPropertyFile(java.lang.String fileName)

A framework.properties file reader/loader.

Parameters:

fileName - The name of property file to read.

Returns:

The Properties Object with bundle of key properties.

getTheHost

private static java.lang.String getTheHost(java.lang.String _theHost)

Return the correct IP-Address to host-name parameter.

Parameters:

_theHost - Name of host.

Returns:

The IP-Address as String

loadFrameworkProperty

private static java.util.HashMap<java.lang.String,java.lang.String> loadFrameworkProperty()

Added the framework.properties "launcher-artifacts" keys on artifacts-by-classes HashMap variable.

Returns:

HashMap with framework.properties file assigned to.

getJadeListOfInstances

private static java.lang.String getJadeListOfInstances(java.lang.String path,
                                      java.lang.String clazz,
                                      java.lang.String param)

List of available agents instances on /path/ for this kind of toolName.

Parameters:

path - directory name for this class of toolName.

clazz - class of that toolName.

param - technology connected to that instance.

Returns:

an string used by JADE Boot launcher class.

getInfoOfBooting

private static void getInfoOfBooting(java.lang.String[] localArgs2)

The real launched command-line.

Parameters:

localArgs2 - The set of arguments used to launch the agent.