SSE4E

GPSystem - Reference Documentation

Class implementing the Global Platform GPSystem class

Index of Methods

• GPSystem() constructor
• getVersion()
• wait()
• trace()
• isTraceOn()
• markTrace()
• copyTrace()
• getVendorObject()
• getSystemID()
• dateTimeByteString()
• mapFilename()

Constructor

Prototype

None

Description

Exceptions

Example

getVersion()

Prototype

String getVersion()

Description

Retrieve the version of the Global Platform Scripting specification implemented by the runtime.

Return

Exceptions

Example

version = GPSystem.getVersion();

assert(version == "1.1.0");

wait()

Prototype

wait(Number ms)

Description

Wait for a specified period

Arguments

Return

Exceptions

Example

start = new Date().valueOf();
waitingTime = 1000;

GPSystem.wait(waitingTime);

stop = new Date().valueOf();
elapsed = stop - start;

// Allow a tolerance of 10 ms
print("Wait: " + waitingTime + " ms / Elapsed: " + elapsed + " ms");
assert(((elapsed - 50) <= waitingTime) && ((elapsed + 50) >= waitingTime));

trace()

Prototype

boolean trace(Object o)

Description

Append data to the trace file by calling the objects "toString()" method.

Arguments

Return

Exceptions

Example

rval = GPSystem.trace("Testoutput from GPSystem.trace()");
// assert(rval == true);

try {
	GPSystem.trace(null);
}
catch (e) {
	assert(e instanceof GPError);
	assert(e.error == GPError.INVALID_TYPE);
}

isTraceOn()

Prototype

boolean isTraceOn()

Description

Return true if the trace is enabled.

Return

Exceptions

Example

assert(typeof(GPSystem.isTraceOn()) == "boolean");

markTrace()

Prototype

markTrace()

Description

Mark the current position in the trace output for later retrieval of trace output using the copyTrace() method.

Return

Exceptions

Example

GPSystem.markTrace();

copyTrace()

Prototype

String copyTrace()

Description

Return the trace starting with the position marked with the markTrace() method up to the very last entry.

Return

Exceptions

Example

var msg ="Hello World"; 
GPSystem.trace(msg);
var t = GPSystem.copyTrace();

if (t != null) {
	assert(t == msg + "\n");
}

getVendorObject()

Prototype

getVendorObject(String objectName)

Description

Retrieve a vendor specific object

Arguments

Return

Exceptions

Example

try {
	obj = GPSystem.getVendorObject("myObject");
}
catch (e) {
	assert(e instanceof GPError);
	assert(e.error == GPError.OBJECTCREATIONFAILED);
}

getSystemID()

Prototype

getSystemID()

Description

Get the ID of the system.

For the smart card development platform a unique object identifier is returned.

It has the following components: OpenSCDP.Runtime.MajorVersion.MinorVersion.Build.SerialNumber.

Return

Exceptions

Example

var id = GPSystem.getSystemID();
print(id);
var s = id.toString(OID).split(".");

print("Runtime : " + s[s.length - 5]);
print("Major   : " + s[s.length - 4]);
print("Minor   : " + s[s.length - 3]);
print("Build   : " + s[s.length - 2]);
print("Serial  : " + s[s.length - 1]);

dateTimeByteString()

Prototype

dateTimeByteString()

Description

Return a ByteString containing the current date and time

Return

Exceptions

Example

time = GPSystem.dateTimeByteString();
assert(time != null);
assert(time instanceof ByteString);

mapFilename()

Prototype

mapFilename(String filename, Number location)

mapFilename(String filename)

Description

Searches for a file at the given location and maps the filename to the system specific absolute path.

Arguments

Return

Exceptions

Example

absFilename = GPSystem.mapFilename("config.js", GPSystem.SYS);
assert(absFilename != null);

absFilename = GPSystem.mapFilename("config.js");
assert(absFilename != null);

absFilename = GPSystem.mapFilename("novalidfile.js");
assert(absFilename == null);

© Copyright 2003 - 2010 CardContact Software & System Consulting, Minden, Germany