Org.simantics.db - Revision history

Tuukka Lehtonen: /* Current Development */

2010-10-30T20:06:07Z

Current Development

← Older revision		Revision as of 20:06, 30 October 2010
Line 149:		Line 149:
	=Current Development=		=Current Development=
	Planned features:		Planned features:
	* Rework Cluster Structure		* Rework Cluster Structure

	Planned work:		Planned work:
	* [[redmine:projects/simantics/issues?query_id=10\|Open Tickets]]		* [[redmine:projects/simantics/issues?query_id=10\|Open Tickets]]


	== Contact ==		== Contact ==

Tuukka Lehtonen: /* Current Development */

2010-10-30T20:05:57Z

Current Development

← Older revision		Revision as of 20:05, 30 October 2010
Line 152:		Line 152:

	Planned work:		Planned work:
	* [redmine:projects/simantics/issues?query_id=10 Open Tickets]		* [[redmine:projects/simantics/issues?query_id=10\|Open Tickets]]

Tuukka Lehtonen: /* Current Development */

2010-10-30T20:05:42Z

Current Development

← Older revision		Revision as of 20:05, 30 October 2010
Line 148:		Line 148:

	=Current Development=		=Current Development=
	~~The next version 0.8 is currently under development.~~
	* [https://www.simulationsite.net/trac/simantics/query?status=assigned&status=new&status=reopened&col=id&col=summary&col=status&col=type&col=priority&col=milestone&component=org.simantics.db&order=priority&version=0.8 Open 0.8 Tickets]
	* [https://www.simulationsite.net/trac/simantics/query?status=closed&col=id&col=summary&col=status&col=type&col=priority&col=milestone&component=org.simantics.template&order=priority&version=0.8 Closed 0.8 Tickets]


	Planned features:		Planned features:
	* Rework Cluster Structure		* Rework Cluster Structure

	Planned work:		Planned work:
	* [~~https~~:~~//www.simulationsite.net/trac~~/simantics/~~query~~?~~status=assigned&status=new&status=reopened&col=id&col=summary&col=status&col=type&col=priority&col=milestone&component=org.simantics.db&order~~=~~priority~~ Open Tickets]		* [redmine:projects/simantics/issues?query_id=10 Open Tickets]

Tuukka Lehtonen at 17:37, 9 October 2010

2010-10-09T17:37:06Z

← Older revision		Revision as of 17:37, 9 October 2010
Line 3:		Line 3:
	'''[[org.simantics.db.procore]]''' ([[svn:db/trunk/org.simantics.db.procore\|SVN]]) offers an simple implementation of an TCP/IP based client to '''[[org.simantics.db.procore.server]]''' ([[svn:db/trunk/org.simantics.db.procore.server\|SVN]])		'''[[org.simantics.db.procore]]''' ([[svn:db/trunk/org.simantics.db.procore\|SVN]]) offers an simple implementation of an TCP/IP based client to '''[[org.simantics.db.procore.server]]''' ([[svn:db/trunk/org.simantics.db.procore.server\|SVN]])

	'''[[org.simantics.db.tests]]''' ([[svn:db/trunk/org.simantics.db.tests\|SVN]]) ~~provides small set of~~ tests.		'''[[org.simantics.db.tests]]''' ([[svn:db/trunk/org.simantics.db.tests\|SVN]]) contains unit tests for the client library.

	== Reference ==		== Reference ==

Tuukka Lehtonen: /* Links */

2010-10-01T19:14:44Z

Links

← Older revision		Revision as of 19:14, 1 October 2010
Line 15:		Line 15:
	=== [[Tutorial:_Database_Development\|Tutorial]] ===		=== [[Tutorial:_Database_Development\|Tutorial]] ===


	~~== Links ==~~

	* [http://www.simantics.org/hudson/job/db-connector/ Continuous development builds]
	* [http://www.simantics.org/hudson/job/db-connector-release/ Release builds]

	== Download ==		== Download ==

Toni Kalajainen at 12:22, 29 September 2010

2010-09-29T12:22:42Z

← Older revision		Revision as of 12:22, 29 September 2010
Line 13:		Line 13:
	=== [[Resource Serialization]] ===		=== [[Resource Serialization]] ===
	=== [[Undo and Redo]] ===		=== [[Undo and Redo]] ===
	=== [[~~Database_tutorial~~\|Tutorial]] ===		=== [[Tutorial:_Database_Development\|Tutorial]] ===

Toni Kalajainen at 12:22, 29 September 2010

2010-09-29T12:22:12Z

← Older revision		Revision as of 12:22, 29 September 2010
Line 8:		Line 8:

	=== [[Subgraph Extents]] ===		=== [[Subgraph Extents]] ===
	=== [[Graph ~~exchange format~~]] ===		=== [[Transferable Graph]] ===
	=== [[Inverse Relations]] ===		=== [[Inverse Relations]] ===
	=== [[Resource Adaptation]] ===		=== [[Resource Adaptation]] ===

Toni Kalajainen at 09:58, 29 September 2010

2010-09-29T09:58:44Z

@@ Line 4: / Line 4: @@
 '''[[org.simantics.db.tests]]''' ([[svn:db/trunk/org.simantics.db.tests|SVN]]) provides small set of tests.
 == Reference ==
@@ Line 96: / Line 15: @@
 === [[Database_tutorial|Tutorial]] ===
 == Links ==

Toni Kalajainen at 09:52, 29 September 2010

2010-09-29T09:52:28Z

← Older revision		Revision as of 09:52, 29 September 2010
Line 6:		Line 6:

	== Introduction ==		== Introduction ==
			[[File:db1.png\|frame\|center\|480px\|[[File:db1.graphml]]<br/><br/>Database session-level class hierarchy. Use these to manage the session and initiate read and write requests (transactions). Requests can be initiated either synchronously or asynchronously. Synchronous invocations will not return before the request has completed/failed while asynchronous requests will return immediately and completion/failure will be notified through a separate '''Procedure'''.]]

	[[File:~~db1~~.png~~\|center~~\|frame\|[[File:db1.graphml]]<br/><br/>Database session-level class hierarchy. Use these to manage the session and initiate read and write requests (transactions). Requests can be initiated either synchronously or asynchronously. Synchronous invocations will not return before the request has completed/failed while asynchronous requests will return immediately and completion/failure will be notified through a separate '''Procedure'''.]]		[[File:db2.png\|frame\|center\|480px\|[[File:db2.graphml]]<br/><br/>Classes related to accessing the graph database during read and write transactions. ''ReadGraph'', ''AsyncReadGraph'', ''WriteGraph'' and ''WriteOnlyGraph'' are the only way to access the actual statements and values in the database. ''ReadGraph'' is a good place to get started.]]
	~~[[File:db2.png~~\|center\|~~frame~~\|[[File:db2.graphml]]<br/><br/>Classes related to accessing the graph database during read and write transactions. ''ReadGraph'', ''AsyncReadGraph'', ''WriteGraph'' and ''WriteOnlyGraph'' are the only way to access the actual statements and values in the database. ''ReadGraph'' is a good place to get started.]]
	[[File:db3.png\|center\|~~frame~~\|[[File:db3.graphml]]<br/><br/>This image shows all the different kinds of requests that can be performed through ''RequestProcessor'' and ''AsyncRequestProcessor''. Beginners should focus on interfaces '''Read<T>''' and '''Write'''. Note that these request classes have default implementations that should be extended instead of directly implementing the interfaces. See the classes for more info.]]		[[File:db3.png\|frame\|center\|480px\|[[File:db3.graphml]]<br/><br/>This image shows all the different kinds of requests that can be performed through ''RequestProcessor'' and ''AsyncRequestProcessor''. Beginners should focus on interfaces '''Read<T>''' and '''Write'''. Note that these request classes have default implementations that should be extended instead of directly implementing the interfaces. See the classes for more info.]]
	[[File:db4.png\|center\|~~frame~~\|[[File:db4.graphml]]<br/><br/>This image shows the listener and procedure interfaces that can be used along with the read requests for one of two reasons: 1. the read requests were made asynchronously so completion can be reported through a '''Procedure''', 2. the client wants to listen to changes in the result of the performed request. Listeners have a lifecycle determined by their disposedness.]]
			[[File:db4.png\|frame\|center\|480px\|[[File:db4.graphml]]<br/><br/>This image shows the listener and procedure interfaces that can be used along with the read requests for one of two reasons: 1. the read requests were made asynchronously so completion can be reported through a '''Procedure''', 2. the client wants to listen to changes in the result of the performed request. Listeners have a lifecycle determined by their disposedness.]]

	== Quickstart ==		== Quickstart ==

Toni Kalajainen at 09:37, 29 September 2010

2010-09-29T09:37:33Z

← Older revision		Revision as of 09:37, 29 September 2010
Line 20:		Line 20:
	The basic idea is much the same as in [http://java.sun.com/javase/technologies/database/ JDBC] [http://java.sun.com/javase/6/docs/api/java/sql/Driver.html Driver] and [http://java.sun.com/javase/6/docs/api/java/sql/DriverManager.html DriverManager].		The basic idea is much the same as in [http://java.sun.com/javase/technologies/database/ JDBC] [http://java.sun.com/javase/6/docs/api/java/sql/Driver.html Driver] and [http://java.sun.com/javase/6/docs/api/java/sql/DriverManager.html DriverManager].

	<~~source~~ lang="java">		<syntaxhighlight lang="java">
	// Try to load and register the Driver instance with the driver manager		// Try to load and register the Driver instance with the driver manager
	Class.forName("fi.vtt.simantics.procore.ProCoreDriver");		Class.forName("fi.vtt.simantics.procore.ProCoreDriver");
Line 26:		Line 26:
	// Connect to the server at the specified host and credentials.		// Connect to the server at the specified host and credentials.
	Session session = Manager.getSession("procore", InetSocketAddress.createUnresolved("localhost", port), username, password);		Session session = Manager.getSession("procore", InetSocketAddress.createUnresolved("localhost", port), username, password);
	</~~source~~>		</syntaxhighlight>

	=== Reading the database ===		=== Reading the database ===

	; Synchronous primitive read		; Synchronous primitive read
	<~~source~~ lang="java">		<syntaxhighlight lang="java">
	Boolean readBooleanProperty(RequestProcessor processor, final Resource resource, final Resource property) {		Boolean readBooleanProperty(RequestProcessor processor, final Resource resource, final Resource property) {
	return processor.syncRequest(new Read<Boolean>() {		return processor.syncRequest(new Read<Boolean>() {
Line 39:		Line 39:
	});		});
	}		}
	</~~source~~>		</syntaxhighlight>

	=== Writing the database ===		=== Writing the database ===

	; Synchronous write requests		; Synchronous write requests
	<~~source~~ lang="java">		<syntaxhighlight lang="java">
	Resource createLibrary(WriteGraph graph) throws DatabaseException {		Resource createLibrary(WriteGraph graph) throws DatabaseException {
	Builtins b = graph.getBuiltins();		Builtins b = graph.getBuiltins();
Line 74:		Line 74:
	processor.syncRequest(new CreateLibrary(container));		processor.syncRequest(new CreateLibrary(container));
	}		}
	</~~source~~>		</syntaxhighlight>

	=== Repairing corrupted database ===		=== Repairing corrupted database ===