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.