Child pages
  • JSServer

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

padding0px
width80px

...

Table Row (tr)
styleheight: 30px;
Table Head (th)
colspan2
Method Summary

...

Table Cell (td)
JSTableObject

...

DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY (EXCEPT INSIDE THE DIV BELOW WITH ID=DESCRIPTION), UNLESS YOU KNOW WHAT YOU'RE DOING.
THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO AUTO UPDATE THE CONTENT THROUGH THE DOC GENERATOR.
Enter additional information related to this 'class' inside the {div} macro with 'id=description'
Divcache
styleindexdisplay:none

...

iddescription

...

true
refresh100d
showRefreshtrue
iddoc
titleRefresh page
showDatetrue
retryEnable

servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClient

servoy sSummary12%30%58%height: 30px;3Methods SummaryCreates in this server a new table with the specified name.

...

Table Cell (td)
Boolean

...

Table Cell (td)
JSTableObject

...

Drops the table with the specified name from this server.

...

Returns a JSTable instance corresponding to the table with the specified name from this server.

...

Table Cell (td)
String[]

...

Returns an array with the names of all tables in this server.

...

Table Cell (td)
Boolean

...

Get valid state for the server.

...

void

...

Reloads the datamodel from the database, if changed externally or via rawSQL plugin.

...

Table Cell (td)
Boolean

...

Synchronizes a JSTable instance with the database.

...

...

function

...

servoy sDetail

...

padding0px
width100%

...

2100%height:30px

...

Table Head (th)
colspan1
Method Details

...

idcreateNewTable-String
Table Row (tr)
idname
Table Cell (td)
createNewTable

...

idsig

...

Span
stylemargin-right: 5px;
JSTableObject
Span
stylefont-weight: bold;
createNewTable

...

2Methods DetailscreateNewTablename

createNewTable(tableName)

...

des

...

sIndent
Creates in this server a new table with the specified name.

...

prs

...

Parameters

...

sIndent

...

tableName

...

The name of the table to create.

...

ret

...

Returns

...

sIndent

...

...

idprs

...

classsIndent

...

JSTableObject created table.clients

Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server)
{
	var table = server.createNewTable("new_table");
	if (table) {
		var pk = table.createNewColumn("new_table_id", JSColumn.INTEGER, 0);
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		if (server.synchronizeWithDB(table))
			application.output("New table created in the database.");
		else
			application.output("New table not created in database.");
	}
	else application.output("New table not created at all.");
}

...

classlastDetailRow

...

iddropTable-String
Table Row (tr)
idname
Table Cell (td)
dropTable
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
dropTable
Span
(tableName)
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Drops the table with the specified name from this server.

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
dropTablename

dropTable(tableName)

dessIndent
Drops the table with the specified name from this server.
prs

Parameters

sIndenttableNameThe name of the table to drop.

...

ret

...

Returns

...

sIndent

...

...

boolean success.clients

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

...

classlastDetailRow

...

idgetTable-String
Table Row (tr)
idname
Table Cell (td)
getTable
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
JSTableObject
Span
stylefont-weight: bold;
getTable
Span
(tableName)
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns a JSTable instance corresponding to the table with the specified name from this server.

...

idprs

...

classsIndent

...

Sample

...

classsIndent

...

Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var result = server.dropTable("new_table");
	if (result)
		application.output("Table dropped.");
	else
		application.output("Table not dropped.");
}

...

sIdentjavascriptlastDetailRowgetTablename

getTable(tableName)

dessIndent
Returns a JSTable instance corresponding to the table with the specified name from this server.
prs

Parameters

sIndenttableNameThe name of the table to retrieve.

...

ret

...

Returns

...

...

sIndent

...

...

JSTableObject table.clients

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

...

classlastDetailRow

...

idgetTableNames
Table Row (tr)
idname
Table Cell (td)
getTableNames
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
String[]
Span
stylefont-weight: bold;
getTableNames
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Returns an array with the names of all tables in this server.

...

idret

...

classsIndent

...

Sample

...

classsIndent

...

Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var table = server.getTable("employees");
	if (table) {
		var colNames = table.getColumnNames()
		application.output("Table has " + colNames.length + " columns.");
		for (var i=0; i<colNames.length; i++)
			application.output("Column " + i + ": " + colNames[i]);
	}
}
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
isValid
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Get valid state for the server.
Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
Boolean - boolean valid state.
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (!server.isValid()) {
	application.output("Server not valid!");
}

...

classlastDetailRow

...

idreloadDataModel
Table Row (tr)
idname
Table Cell (td)
reloadDataModel
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
void
Span
stylefont-weight: bold;
reloadDataModel
Span
()
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent

Reloads the datamodel from the database, if changed externally or via rawSQL plugin.

This call is not needed after a call to synchronizeWithDB().

Table Row (tr)
idret
Table Cell (td)
Returns
Div
classsIndent
void
Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
var result = plugins.rawSQL.executeSQL("example_data", null, 'CREATE TABLE raw_table (raw_table_id INTEGER)');
if (result) {
	application.output("Table created through rawSQL plugin.");
	if (server) {
		server.reloadDataModel();
		// All existing JSTableObject/JSColumn object references are invalid now! Use getTable to get new ones.
		var table = server.getTable("raw_table");
		if (table) {
			var colNames = table.getColumnNames()
			application.output("Table has " + colNames.length + " columns.");
			for (var i=0; i<colNames.length; i++)
				application.output("Column " + i + ": " + colNames[i]);
		}
	}
}
else {
	application.output("Raw table creation failed: " + plugins.rawSQL.getException());
}

...

classlastDetailRow

...

idsynchronizeWithDB-JSTableObject
Table Row (tr)
idname
Table Cell (td)
synchronizeWithDB
Table Row (tr)
idsig
Table Cell (td)
Span
stylemargin-right: 5px;
Boolean
Span
stylefont-weight: bold;
synchronizeWithDB
Span
(table)
Table Row (tr)
iddes
Table Cell (td)
Div
classsIndent
Synchronizes a JSTable instance with the database. If columns were added to or removed from the JSTable instance, all these changes will now be persisted to the database.

...

idprs

...

classsIndent

...

sIdentjavascriptlastDetailRowgetTableNamesname

getTableNames()

dessIndent
Returns an array with the names of all tables in this server.
ret

Returns

sIndent Array of String table names.
clients

Table Row (tr)
idsam
Table Cell (td)
Sample
Div
classsIndent
Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server) {
	var tableNames = server.getTableNames();
	application.output("There are " + tableNames.length + " tables.");
	for (var i=0; i<tableNames.length; i++)
		application.output("Table " + i + ": " + tableNames[i]);
}
else {
	plugins.dialogs.showInfoDialog("Attention","Server 'example_data' cannot be found.","OK");
}

...

classlastDetailRow

...

idisValid
Table Row (tr)
idname
Table Cell (td)
isValid

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
isValidname

isValid()

dessIndent
Get valid state for the server.
ret

Returns

sIndent boolean valid state.
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
reloadDataModelname

reloadDataModel()

dessIndent
Reloads the datamodel from the database, if changed externally or via rawSQL plugin.

This call is not needed after a call to synchronizeWithDB().
clients

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

Sample

sIdentjavascript
lastDetailRow
synchronizeWithDBname

synchronizeWithDB(table)

dessIndent
Synchronizes a JSTable instance with the database. If columns were added to or removed from the JSTable instance, all these changes will now be persisted to the database.
prs

Parameters

sIndenttableA JSTableObject instance that should be synchronized.

...

ret

...

Returns

...

sIndent

...

...

boolean success.clients

...

Supported Clients

sIndentSmartClient,WebClient,NGClient
sam

...

classlastDetailRow

...

Sample

...

classsIndent

...

Code Block
languagejavascript
var server = plugins.maintenance.getServer("example_data");
if (server)
{
	var table = server.createNewTable("new_table");
	if (table) {
		var pk = table.createNewColumn("new_table_id", JSColumn.INTEGER, 0);
		pk.rowIdentifierType = JSColumn.PK_COLUMN;
		if (server.synchronizeWithDB(table))
			application.output("New table created in the database.");
		else
			application.output("New table not created in database.");
	}
	else application.output("New table not created at all.");
}
sIdentjavascriptlastDetailRow