genius.core

Class Global

java.lang.Object

genius.core.Global

public class Global
extends java.lang.Object

Overview of global variables used throughout the application.

Author:

dmytro

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AGENT_REPOSITORY Path to agent repository
static java.lang.String	DOMAIN_REPOSITORY Path to domain repository
static java.lang.String	logPrefix
static java.lang.String	logPreset
static java.lang.String	PROTOCOL_REPOSITORY Path to protocol repository
static java.lang.String	SIMULATOR_REPOSITORY Path to simulator repository

Constructor Summary

Constructors

Constructor and Description
Global()

Method Summary

Modifier and Type	Method and Description
static Protocol	createProtocolInstance(ProtocolRepItem protRepItem, AgentRepItem[] agentRepItems, ProfileRepItem[] profileRepItems, java.util.HashMap<AgentParameterVariable,AgentParamValue>[] agentParams)
static <T> T	deserializeObject(java.io.InputStream is) Deserializes an object and casts it to the given type.
static java.lang.String	getAgentDescription(Agent agent) Gives a useful agent name.
static java.lang.String	getCurrentTime()
static java.lang.String	getDistributedOutcomesFileName()
static java.lang.String	getExtensiveOutcomesFileName()
static java.lang.String	getFileNameWithoutExtension(java.lang.String fileName)
static java.lang.String	getOQMOutcomesFileName()
static java.lang.String	getOutcomesFileName()
static java.lang.Class<Protocol>	getProtocolClass(ProtocolRepItem protRepItem)
static java.lang.String	getTournamentOutcomeFileName()
static Agent	loadAgent(java.lang.String path) Load an agent using the given classname/filename.
static Agent	loadAgent(java.lang.String agentClassName, java.lang.String variables) load agent and then set the parameters.
static java.lang.Object	loadClassFromFile(java.io.File file) Load a file as a class.
static java.lang.Object	loadObject(java.lang.String path) Load an object from a given path.
static java.lang.Object	loadObject(java.lang.String path, java.lang.Class<?> expectedClass) Runtime type-checked version of loadObject(String).
static java.lang.String	nameOfClass(java.lang.String classname1)
static void	serializeObject(java.io.OutputStream outputStream, java.io.Serializable object) Serialize a serializable object to a outputstream.
static java.lang.String	shortNameOfClass(java.lang.String classname1)
static void	showLoadError(java.io.File fc, java.lang.Throwable e) Show a dialog to the user, explaining the exception that was raised while loading file fc.

Methods inherited from class java.lang.Object

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

Field Detail

DOMAIN_REPOSITORY

public static final java.lang.String DOMAIN_REPOSITORY

Path to domain repository

See Also:

Constant Field Values

AGENT_REPOSITORY

public static final java.lang.String AGENT_REPOSITORY

Path to agent repository

See Also:

Constant Field Values

PROTOCOL_REPOSITORY

public static final java.lang.String PROTOCOL_REPOSITORY

Path to protocol repository

See Also:

Constant Field Values

SIMULATOR_REPOSITORY

public static final java.lang.String SIMULATOR_REPOSITORY

Path to simulator repository

See Also:

Constant Field Values

logPrefix

public static java.lang.String logPrefix

logPreset

public static java.lang.String logPreset

Constructor Detail

Global

public Global()

Method Detail

getCurrentTime

public static java.lang.String getCurrentTime()

getFileNameWithoutExtension

public static java.lang.String getFileNameWithoutExtension(java.lang.String fileName)

getProtocolClass

public static java.lang.Class<Protocol> getProtocolClass(ProtocolRepItem protRepItem)
                                                  throws java.lang.Exception

Throws:

java.lang.Exception

createProtocolInstance

public static Protocol createProtocolInstance(ProtocolRepItem protRepItem,
                                              AgentRepItem[] agentRepItems,
                                              ProfileRepItem[] profileRepItems,
                                              java.util.HashMap<AgentParameterVariable,AgentParamValue>[] agentParams)
                                       throws InstantiateException

Throws:

InstantiateException

loadObject

public static java.lang.Object loadObject(java.lang.String path)
                                   throws InstantiateException

Load an object from a given path. If it's a .class file, figure out the correct class path and use that. If it's not a .class file, we assume it's already in the existing classpath and load it with the standard class loader.

we can't properly typecheck here. Generics fail as we have type erasure, and casting to the given type does NOTHING. So we leave this a general object and leave it to the caller to do the type checking.

Parameters:

path - This can be either a class name or filename.

• class name like"agents.anac.y2010.AgentFSEGA.AgentFSEGA". In this case the agent must be already on the JVM's classpath otherwise the agent will not be found.
  
• a full path, eg "/Volumes/documents/NegoWorkspace3/NegotiatorGUI/src/agents/anac/y2010/AgentFSEGA/AgentFSEGA.java" . In this case, we can figure out the class path ourselves, but the ref is system dependent (backslashes on windows) and might be absolute path.

Returns:

the Object in the given file

Throws:

InstantiateException - if path can not be loaded as object.

loadObject

public static java.lang.Object loadObject(java.lang.String path,
                                          java.lang.Class<?> expectedClass)
                                   throws InstantiateException

Runtime type-checked version of loadObject(String).

Parameters:

path -

expectedClass - the class type that the loaded object must extend.

Returns:

loaded object.

Throws:

InstantiateException

deserializeObject

public static <T> T deserializeObject(java.io.InputStream is)
                               throws java.lang.ClassNotFoundException,
                                      java.io.IOException

Deserializes an object and casts it to the given type.

Parameters:

is - the input stream containing serialized object.

Returns:

object contained in given stream.

Throws:

java.io.IOException - if file can not be found

java.lang.ClassNotFoundException - if class in the object can't be found

java.lang.ClassCastException - if not of given class type

serializeObject

public static void serializeObject(java.io.OutputStream outputStream,
                                   java.io.Serializable object)
                            throws java.io.IOException

Serialize a serializable object to a outputstream.

Parameters:

outputStream - the stream to write to

object - the object to store

Throws:

java.io.IOException

loadClassFromFile

public static java.lang.Object loadClassFromFile(java.io.File file)
                                          throws java.net.MalformedURLException,
                                                 java.lang.InstantiationException,
                                                 java.lang.IllegalAccessException,
                                                 java.lang.ClassNotFoundException

Load a file as a class. It 'reverse engineers' the correct path by first just trying to load the file. Assuming the file exists, we probably get an error that we then use to determine the correct base directory.

Parameters:

file - the object to be loaded. Filename should end with ".class".

Returns:

the object contained in the file.

Throws:

java.lang.ClassNotFoundException

java.lang.IllegalAccessException

java.lang.InstantiationException

java.net.MalformedURLException

loadAgent

public static Agent loadAgent(java.lang.String path)
                       throws InstantiateException

Load an agent using the given classname/filename. DOES NOT call Agent.parseStrategyParameters(String)

Parameters:

path - This can be either a class name or filename.

• class name like"agents.anac.y2010.AgentFSEGA.AgentFSEGA". In this case the agent must be already on the JVM's classpath otherwise the agent will not be found.
• a full path, eg "/Volumes/documents/NegoWorkspace3/NegotiatorGUI/src/agents/anac/y2010/AgentFSEGA/AgentFSEGA.java" . In this case, we can figure out the class path ourselves, but the ref is system dependent (backslashes on windows) and might be absolute path.

Returns:

instantiated agent ready to use.

Throws:

InstantiateException - if object can't be loaded

loadAgent

public static Agent loadAgent(java.lang.String agentClassName,
                              java.lang.String variables)
                       throws InstantiateException

load agent and then set the parameters. See loadAgent(String)

Parameters:

agentClassName -

variables - the variables to use, as string (eg, "time=0.9;e=1.0").

Returns:

the agent contained in the given class name, and using the given variables.

Throws:

InstantiateException - if class can't be loaded

getAgentDescription

public static java.lang.String getAgentDescription(Agent agent)

Gives a useful agent name.

showLoadError

public static void showLoadError(java.io.File fc,
                                 java.lang.Throwable e)

Show a dialog to the user, explaining the exception that was raised while loading file fc. Typically this is used in combination with loadObject(String) and associates. Also dumps a copy of the full stacktrace to the console, to help us debugging #906

Parameters:

fc - file that was attempted to be loaded

e - the exception that was raised

getOutcomesFileName

public static java.lang.String getOutcomesFileName()

getDistributedOutcomesFileName

public static java.lang.String getDistributedOutcomesFileName()

getTournamentOutcomeFileName

public static java.lang.String getTournamentOutcomeFileName()

getExtensiveOutcomesFileName

public static java.lang.String getExtensiveOutcomesFileName()

getOQMOutcomesFileName

public static java.lang.String getOQMOutcomesFileName()

nameOfClass

public static java.lang.String nameOfClass(java.lang.String classname1)

Parameters:

classname -

Returns:

Removes trailing ".class" from string if it is there. In absolute paths, the \ and / are replaced with '.' and we do as if that is a fully specified class path (it isn't but it gives at least some 'short name')

shortNameOfClass

public static java.lang.String shortNameOfClass(java.lang.String classname1)

Parameters:

classname -

Returns:

Removes trailing ".class" from string if it is there. If there is no "." in the remainder, the remainder is returned. Otherwise, the string after the last "." in the remainder is returned. In absolute paths, the \ and / are replaced with '.' and we do as if that is a fully specified class path (it isn't but it gives at least some 'short name')