Difference between revisions of "Template:PackageDocumentIntroduction"

From emotive
Jump to navigation Jump to search
(Created page with "OTX documents can be stored in a file system or in a database. If stored in a file system, certain constraints on the organisation of files and folders allow...")
 
Line 1: Line 1:
[[OtxDocuments|OTX documents]] can be stored in a file system or in a database. If stored in a file system, certain constraints on the organisation of files and folders allow a simple implementation to find OTX documents easily. The package name (in dotted notation) can simply be translated into a directory path or vice versa, whereas the OTX document name can be translated directly to the file name. It is an analogy to the file system organisation of packages and classes recommended the Java Language Specification.
+
[[OtxDocuments|OTX documents]] can be stored in a file system or in a database. If stored in a file system, certain constraints on the organisation of files and folders allow a simple implementation to find OTX documents easily. The [[OtxPackages|package]] name (in dotted notation) can simply be translated into a directory path or vice versa, whereas the OTX document name can be translated directly to the file name. It is an analogy to the file system organisation of packages and classes recommended the Java Language Specification.
  
  
Line 6: Line 6:
 
| '''Java''' || '''C#''' || '''OTX''' || '''File System'''
 
| '''Java''' || '''C#''' || '''OTX''' || '''File System'''
 
|-{{TableRow1}}
 
|-{{TableRow1}}
| Package || Namespace || Package || Folder
+
| Package || Namespace || [[OtxPackages|Package]] || Folder
 
|-{{TableRow2}}
 
|-{{TableRow2}}
| Document || Document || Document || File
+
| Document || Document || [[OtxDocuments|Document]] || File
 
|-{{TableRow1}}
 
|-{{TableRow1}}
 
| Class || Class || document name || File content
 
| Class || Class || document name || File content
Line 15: Line 15:
 
|}
 
|}
  
{{Important|OTX documents are unambiguously identified with the combination of package name and their own name. This allows for having equal document names in different OTX packages and avoiding ambiguity.}}
+
{{Important|[[OtxDocuments|OTX documents]] are unambiguously identified with the combination of package name and their own name. This allows for having equal document names in different [[OtxPackages|OTX packages]] and avoiding ambiguity.}}
  
{{Important|Global entities (global constants, procedures, validities, etc.) contained in the OTX document are unambiguously identified with the combination of package- and document-name, and their name. This allows for having equal global names in different OTX files and avoiding ambiguity.}}
+
{{Important|Global entities (global constants, procedures, validities, etc.) contained in the [[OtxDocuments|OTX document]] are unambiguously identified with the combination of package- and document-name, and their name. This allows for having equal global names in different OTX files and avoiding ambiguity.}}
  
 
{{Important|Due to the fact that the package name of an document shall not be empty, a so called Root-Package (root folder) shall be exist.}}
 
{{Important|Due to the fact that the package name of an document shall not be empty, a so called Root-Package (root folder) shall be exist.}}
  
 
{{ImageStyleCenter|OtxDocumentStorageStructure.png|600|Package/Document Structure}}
 
{{ImageStyleCenter|OtxDocumentStorageStructure.png|600|Package/Document Structure}}

Revision as of 09:41, 27 November 2014

OTX documents can be stored in a file system or in a database. If stored in a file system, certain constraints on the organisation of files and folders allow a simple implementation to find OTX documents easily. The package name (in dotted notation) can simply be translated into a directory path or vice versa, whereas the OTX document name can be translated directly to the file name. It is an analogy to the file system organisation of packages and classes recommended the Java Language Specification.


Java C# OTX File System
Package Namespace Package Folder
Document Document Document File
Class Class document name File content
Analogies between Java, C # and OTX
Exclamation.png Important: OTX documents are unambiguously identified with the combination of package name and their own name. This allows for having equal document names in different OTX packages and avoiding ambiguity.
Exclamation.png Important: Global entities (global constants, procedures, validities, etc.) contained in the OTX document are unambiguously identified with the combination of package- and document-name, and their name. This allows for having equal global names in different OTX files and avoiding ambiguity.
Exclamation.png Important: Due to the fact that the package name of an document shall not be empty, a so called Root-Package (root folder) shall be exist.
OtxDocumentStorageStructure.png
Package/Document Structure