You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by an...@apache.org on 2011/11/21 13:06:42 UTC

svn commit: r1204461 - in /incubator/jena/site/trunk/content/jena/documentation/assembler: assembler-howto.mdtext index.mdtext inside-assemblers.mdtext

Author: andy
Date: Mon Nov 21 12:06:42 2011
New Revision: 1204461

URL: http://svn.apache.org/viewvc?rev=1204461&view=rev
Log:
Remove RDB assembler documentation

Modified:
    incubator/jena/site/trunk/content/jena/documentation/assembler/assembler-howto.mdtext
    incubator/jena/site/trunk/content/jena/documentation/assembler/index.mdtext
    incubator/jena/site/trunk/content/jena/documentation/assembler/inside-assemblers.mdtext

Modified: incubator/jena/site/trunk/content/jena/documentation/assembler/assembler-howto.mdtext
URL: http://svn.apache.org/viewvc/incubator/jena/site/trunk/content/jena/documentation/assembler/assembler-howto.mdtext?rev=1204461&r1=1204460&r2=1204461&view=diff
==============================================================================
--- incubator/jena/site/trunk/content/jena/documentation/assembler/assembler-howto.mdtext (original)
+++ incubator/jena/site/trunk/content/jena/documentation/assembler/assembler-howto.mdtext Mon Nov 21 12:06:42 2011
@@ -75,7 +75,7 @@ the next sections.
 ## Specifications common to all models
 
 Assembler specifications can describe many kinds of models: memory,
-inference, database, ontology, and file-backed. All of these model
+inference, ontology, and file-backed. All of these model
 specifications share a set of base properties for attaching
 content, prefix mappings, and reification modes.
 
@@ -196,120 +196,6 @@ resources. The subgraphs rooted at those
 algorithm from `ResourceUtils.reachableClosure()`) are added to the
 content.
 
-### RDB models and Connections
-
-The description of an RDB model requires its name and a description
-of the JDBC connection for the database the model is in. For
-example:
-
-    eg:database-example
-        ja:connection eg:connection ;
-          ja:modelName "Thunderbird3"
-        .
-    eg:connection
-        ja:dbType "MySQL" ;
-          ja:dbURL <jdbc:mysql://localhost/test> ;
-          ja:dbUser "cjd"
-        .
-
-    ja:RDBModel a rdfs:Class ;
-      rdfs:subClassOf ja:Connectable ;
-      rdfs:subClassOf [owl:onProperty ja:connection; owl:cardinality 1] ;
-      rdfs:subClassOf ja:NamedModel
-    .
-
-    ja:Connectable a rdfs:Class ;
-      rdfs:subClassOf ja:Object
-    .
-    ja:connection a rdf:Property ;
-      rdfs:domain ja:Connectable ;
-      rdfs:range ja:Connection
-    .
-
-    ja:NamedModel a rdfs:Class ;
-      rdfs:subClassOf [owl:onProperty ja:modelName; owl:cardinality 1] ;
-      rdfs:subClassOf ja:Model
-    .
-    ja:modelName a rdf:Property ;
-      rdfs:domain ja:NamedModel
-    .
-
-`ja:RDBModel` is a subclass of `ja:NamedModel` and shares the
-`ja:ModelName` property value naming the model within the
-database.
-
-The mandatory unique property value of `ja:connection` specifies
-the connection to the database to be used.
-
-The description of a connection requires the database name and type
-and the user name and password. If the username and password are
-not specified, `Assembler.general` will default them, normally to
-the values of the system properties `jena.dbUser` and
-`jena.dbPassword`.
-
-    ja:Connection a rdfs:Class ;
-      rdfs:subClassOf [owl:onProperty ja:dbType; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbClass; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbTypeProperty; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbURL; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbClassProperty; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbUser; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbPassword; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbUserProperty; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbPasswordProperty; owl:maxCardinality 1] ;
-      rdfs:subClassOf [owl:onProperty ja:dbURLProperty; owl:maxCardinality 1] ;
-      rdfs:subClassOf ja:Object
-    .
-    ja:dbTypeProperty a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbPasswordProperty a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbType a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbURL a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbPassword a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbURLProperty a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbUserProperty a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbClass a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbClassProperty a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-    ja:dbUser a rdf:Property ;
-      rdfs:domain ja:Connection
-    .
-
-The `ja:dbURL` property value specifies the URL of the database to
-be connected to. If it is omitted, the `ja:dbURLProperty` value is
-the name of a Java system property whose value is the URL of the
-database.
-
-The `ja:dbType` property value specifies the type of the database
-as a string. If it is omitted, the `ja:dbTypeProperty` value is the
-name of a Java system property whose value is the database type.
-
-The unique `ja:dbUser` property value is a string literal whose
-value is the name of the user connecting to the database. If it is
-omitted, the value of the `ja:dbUserProperty` is the name of a Java
-system property containing the user name.
-
-The unique `ja:dbPassword` property value is the password of the
-user connecting to the database. If it is omitted, the value of the
-`ja:dbPasswordProperty` is the name of a Java system property whose
-value is the password.
-
 ### File models
 
 A FileModel specification builds a memory model that is backed by a
@@ -389,25 +275,15 @@ describes an inference model that uses R
 *reasonerURL* property value is the URI used to identify the
 reasoner (it is the value of the Jena constant
 `RDFSRuleReasonerFactory.URI`). The base model is specified as a
-memory model; if it is left out, an empty memory model is used. Of
-course, you can specify a database model as a base model:
+memory model; if it is left out, an empty memory model is used.
 
-    eg:database-example
-        ja:connection eg:connection ;
-        ja:modelName "Thunderbird3"
-        .
-    eg:connection
-        ja:dbType "MySQL" ;
-        ja:dbURL <jdbc:mysql://localhost/test> ;
-        ja:dbUser "cjd"
-        .
     eg:db-inference-example
-        ja:baseModel eg:database-example ;
+        ja:baseModel eg:model-example ;
         ja:reasoner [ja:reasonerURL <http://jena.hpl.hp.com/2003/RDFSExptRuleReasoner>]
         .
 
 The same reasoner as used as in the previous example, but now the
-base model is a database specified in the same way as our earlier
+base model is a specific model description in the same way as our earlier
 example.
 
 Because Jena's access to external reasoners goes through the same
@@ -619,10 +495,7 @@ appropriate properties:
     `ja:likeBuiltinSpec ja:OWL_MEM`.
 -   `ja:importSource`: The value of this optional unique property
     is a `ModelSource` description which describes where imports are
-    obtained from. A `ModelSource` my be of class `ja:ModelSource`, for
-    which memory models are constructed, or a `ja:RDBModelSource` with
-    a `ja:connection` property, for which models are constructed in the
-    specified database.
+    obtained from. A `ModelSource` is usually of of class `ja:ModelSource`.
 -   `ja:documentManager`: This value of this optional unique
     property is a DocumentManager specification. If absent, the default
     document manager is used.
@@ -644,7 +517,6 @@ appropriate properties:
     -   RDFS: http://www.w3.org/2000/01/rdf-schema\#
     -   DAML: http://www.daml.org/2001/03/daml+oil\#
 
-
 Any unspecified properties have default values, normally taken from
 those of `OntModelSpec.OWL_MEM_RDFS_INF`. However, if the
 OntModelSpec resource is in the JA namespace, and its local name is

Modified: incubator/jena/site/trunk/content/jena/documentation/assembler/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/jena/site/trunk/content/jena/documentation/assembler/index.mdtext?rev=1204461&r1=1204460&r2=1204461&view=diff
==============================================================================
--- incubator/jena/site/trunk/content/jena/documentation/assembler/index.mdtext (original)
+++ incubator/jena/site/trunk/content/jena/documentation/assembler/index.mdtext Mon Nov 21 12:06:42 2011
@@ -55,27 +55,6 @@ the root resource `my:root`.
 inference documentation and code; *theBaseModelResource* is another
 resource in the same document describing the base model.
 
-### ... a database model?
-
-    my:root
-        ja:connection aConnectionresource ;
-        ja:modelName "myModelName"
-        .
-
-    aConnectionResource ;
-        ja:dbURL theDatabaseURL ;
-        ja:dbUser "the user name" ;
-        ja:dbPassword "the user's password" ;
-        ja:dbType "the database type, eg MySQL" ;
-        ja:dbClass "some.jena.driver.class"
-        .
-
-*aConnectionResource* describes the connection to the desired
-database. If a particular Java driver class has to be loaded, it is
-specified by the `dbClass` property value. See the
-[Assembler howto](assembler-howto.html) for ways in which sensitive
-details such as passwords can be left out of the description.
-
 ### ... some initialising content?
 
     my:root

Modified: incubator/jena/site/trunk/content/jena/documentation/assembler/inside-assemblers.mdtext
URL: http://svn.apache.org/viewvc/incubator/jena/site/trunk/content/jena/documentation/assembler/inside-assemblers.mdtext?rev=1204461&r1=1204460&r2=1204461&view=diff
==============================================================================
--- incubator/jena/site/trunk/content/jena/documentation/assembler/inside-assemblers.mdtext (original)
+++ incubator/jena/site/trunk/content/jena/documentation/assembler/inside-assemblers.mdtext Mon Nov 21 12:06:42 2011
@@ -160,9 +160,7 @@ produces | Class | Type | constant
 default models | DefaultModelAssembler | ja:DefaultModel | defaultModel
 memory models | MemoryModelAssembler | ja:MemoryModel | memoryModel
 inference models| InfModelAssembler | ja:InfModel | infModel
-RDB models | RDBModelAssembler | ja:RDBModel | rdbModel
 reasoners | ReasonerAssembler | ja:Reasoner | reasoner
-connection descriptions | ConnectionAssembler | ja:Connection | connection
 content | ContentAssembler | ja:Content | content
 ontology models | OntModelAssembler | ja:OntModel | ontModel
 rules | RuleSetAssembler | ja:RuleSet | rules
@@ -191,23 +189,6 @@ Invoking the `fill` method adds the repr
 model. The supplied ModelAssemblers automatically apply the
 `Content` objects corresponding to `ja:content` property values.
 
-### Basic assembler ConnectionAssembler
-
-A ConnectionAssembler constructs ConnectionDescriptions according
-to the specification. An ConnectionDescription retains the
-information required to make a database connection, can constructs
-that connection on demand.
-
-When a ConnectionAssembler is constructed, it may optionally be
-given a Resource describing (using the JA vocabulary) default
-values for any of the database properties. When that Assembler is
-used to create a Connection, missing values are filled in from the
-defaults. This allows sensitive information to be left out of the
-RDF description.
-
-The ConnectionAssembler embedded in Assembler.general has defaults
-taken from the system properties `jena.dbUser` and `jena.dbType`
-
 ### Basic assembler RulesetAssembler
 
 A RulesetAssembler generates lists of Jena rules.