You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2015/09/18 21:04:01 UTC
svn commit: r1703910 - /directory/site/trunk/content/api/user-guide/
Author: elecharny
Date: Fri Sep 18 19:04:01 2015
New Revision: 1703910
URL: http://svn.apache.org/viewvc?rev=1703910&view=rev
Log:
Some page raeaorgainaztion and link fixing
Added:
directory/site/trunk/content/api/user-guide/4.1.1-schema-objects.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.1-attribute-types.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.2-object-classes.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.3-syntaxes.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.4-matching-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.5-dit-content-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.6-dit-structure-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.7-matching-rule-uses.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.8-name-forms.mdtext
directory/site/trunk/content/api/user-guide/4.1.1.9-apacheds-schema-elements.mdtext
directory/site/trunk/content/api/user-guide/4.1.2-registries.mdtext
directory/site/trunk/content/api/user-guide/4.1.3-schema-loader.mdtext
Removed:
directory/site/trunk/content/api/user-guide/4.1.2-schema-object.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.1-attribute-types.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.2-object-classes.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.3-syntaxes.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.4-matching-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.5-dit-content-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.6-dit-structure-rules.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.7-matching-rule-uses.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.8-name-forms.mdtext
directory/site/trunk/content/api/user-guide/4.1.2.9-apacheds-schema-elements.mdtextt
directory/site/trunk/content/api/user-guide/4.1.3-registries.mdtext
directory/site/trunk/content/api/user-guide/4.1.4-schema-loader.mdtext
Modified:
directory/site/trunk/content/api/user-guide/4-schema-management.mdtext
directory/site/trunk/content/api/user-guide/4.1-schema-manager.mdtext
Modified: directory/site/trunk/content/api/user-guide/4-schema-management.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4-schema-management.mdtext?rev=1703910&r1=1703909&r2=1703910&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/4-schema-management.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/4-schema-management.mdtext Fri Sep 18 19:04:01 2015
@@ -31,16 +31,15 @@ A LDAP Schema is a complex combinaison o
## Contents
* [SchemaManager](4.1-schema-manager.html)
- * [Introduction](4.1.1-schema-manager-introduction.html)
- * [SchemaObject](4.1.2-schema-object.html)
- * [AttributeTypes](4.1.2.1-attribute-types.html)
- * [ObjectClasses](4.1.2.2-object-classes.html)
- * [Syntaxes](4.1.2.3-syntaxes.html)
- * [MatchingRules](4.1.2.4-matching-rules.html)
- * [DITContentRules](4.1.2.5-dit-content-rules.html)
- * [DITStructureRules](4.1.2.6-dit-structure-rules.html)
- * [MatchingRuleUses](4.1.2.7-matching-rule-uses.html)
- * [NameForms](4.1.2.8-name-forms.html)
- * [ApacheDS Schema Elements](4.1.2.9-apacheds-schema-elements.html)
- * [Registries](4.1.3-registries.html)
- * [SchemaLoader](4.1.4-schema-loader.html)
+ * [SchemaObjects](4.1.1-schema-objects.html)
+ * [AttributeTypes](4.1.1.1-attribute-types.html)
+ * [ObjectClasses](4.1.1.2-object-classes.html)
+ * [Syntaxes](4.1.1.3-syntaxes.html)
+ * [MatchingRules](4.1.1.4-matching-rules.html)
+ * [DITContentRules](4.1.1.5-dit-content-rules.html)
+ * [DITStructureRules](4.1.1.6-dit-structure-rules.html)
+ * [MatchingRuleUses](4.1.1.7-matching-rule-uses.html)
+ * [NameForms](4.1.1.8-name-forms.html)
+ * [ApacheDS Schema Elements](4.1.1.9-apacheds-schema-elements.html)
+ * [Registries](4.1.2-registries.html)
+ * [SchemaLoader](4.1.3-schema-loader.html)
Modified: directory/site/trunk/content/api/user-guide/4.1-schema-manager.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1-schema-manager.mdtext?rev=1703910&r1=1703909&r2=1703910&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1-schema-manager.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/4.1-schema-manager.mdtext Fri Sep 18 19:04:01 2015
@@ -3,8 +3,8 @@ NavPrev: 4-schema-management.html
NavPrevText: 4 - Schema Management
NavUp: 4-schema-management.html
NavUpText: 4 - Schema Management
-NavNext: 4.1.1-schema-manager-introduction..html
-NavNextText: 4.1.1 - Introduction
+NavNext: 5-ldap-security.html
+NavNextText: 5 - LDAP Security
Notice: Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
@@ -29,19 +29,37 @@ The API and the ApacheDS server have to
## Contents
-* [Introduction](4.1.1-schema-manager-introduction.html)
-* [SchemaObject](4.1.2-schema-object.html)
- * [AttributeTypes](4.1.2.1-attribute-types.html)
- * [ObjectClasses](4.1.2.2-object-classes.html)
- * [Syntaxes](4.1.2.3-syntaxes.html)
- * [MatchingRules](4.1.2.4-matching-rules.html)
- * [DITContentRules](4.1.2.5-dit-content-rules.html)
- * [DITStructureRules](4.1.2.6-dit-structure-rules.html)
- * [MatchingRuleUses](4.1.2.7-matching-rule-uses.html)
- * [NameForms](4.1.2.8-name-forms.html)
- * [ApacheDS Schema Elements](4.1.2.9-apacheds-schema-elements.html)
-* [Registries](4.1.3-registries.html)
-* [SchemaLoader](4.1.4-schema-loader.html)
+* [SchemaObjects](4.1.1-schema-objects.html)
+ * [AttributeTypes](4.1.1.1-attribute-types.html)
+ * [ObjectClasses](4.1.1.2-object-classes.html)
+ * [Syntaxes](4.1.1.3-syntaxes.html)
+ * [MatchingRules](4.1.1.4-matching-rules.html)
+ * [DITContentRules](4.1.1.5-dit-content-rules.html)
+ * [DITStructureRules](4.1.1.6-dit-structure-rules.html)
+ * [MatchingRuleUses](4.1.1.7-matching-rule-uses.html)
+ * [NameForms](4.1.1.8-name-forms.html)
+ * [ApacheDS Schema Elements](4.1.1.9-apacheds-schema-elements.html)
+* [Registries](4.1.2-registries.html)
+* [SchemaLoader](4.1.43-schema-loader.html)
+
+## Introduction
+
+The **SchemaManager** stores all the Schema elements (**[AttributeTypes (e)]()**, **[ObjectClasses (e)]()**, ... Internally, we store those elements into what we call the **Registries**, which are hives where each Schema Objects are stored. Each schema element has a dedicated **Registry**. Think of it as a Map which returns a reference to a specific Schema Element when you know it's name or its OID.
+
+ Note : each Schema Element is properly defined by one of its names or its OID. The OID is unique across all the schema elements,
+ when the name can be used in different schema element (for instance, the **audio** AttributeType or ObjectClass)
+
+From the user point of view, the **SchemaManager** is seen as a representation of the available LDAP schema elements. It can of course be extended, or modified, by adding or removing some schema elements. For historic reasons, the schema elements are gathered into what we call a **schema**. Usually, this is what you load into a **schemaManager**
+
+The server has one instance of a **SchemaManager**, which is used internally, and a user won't control it, in any case. On the client side, we can load a **SchemaManager** either from the server (and then we have a duplicated instance), or from existing schema files. We can even create a brand new **SchemaManager** and fill it with all what we need.
+
+## The various pieces of the puzzle...
+
+Creating a **SchemaManager** results in a complex structure to be created, and involves a lot of other helper class to be used. We will separate the description in three groups :
+
+* The elements stored in the **SchemaManager**
+* The containers in which those **SchemaObject** instances are stored, called **Registries**
+* The classes used to initialize the **SchemaManager**, called the **SchemaLoader** (whch comes in various flavors)
## Getting a SchemaManager
Added: directory/site/trunk/content/api/user-guide/4.1.1-schema-objects.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1-schema-objects.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1-schema-objects.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1-schema-objects.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,95 @@
+Title: 4.1.1 - Schema Objects
+NavPrev: 4.1-schema-manager.html
+NavPrevText: 4.1 - Schema Manager
+NavUp: 4.1-schema-manager.html
+NavUpText: 4.1 - Schema Manager
+NavNext: 4.1.2-registries.html
+NavNextText: 4.1.2 - Registries
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.2 - Schema Objects
+
+## Content
+
+* [AttributeTypes](4.1.1.1-attribute-types.html)
+* [ObjectClasses](4.1.1.2-object-classes.html)
+* [Syntaxes](4.1.1.3-syntaxes.html)
+* [MatchingRules](4.1.1.4-matching-rules.html)
+* [DITContentRules](4.1.1.5-dit-content-rules.html)
+* [DITStructureRules](4.1.1.6-dit-structure-rules.html)
+* [MatchingRuleUses](4.1.1.7-matching-rule-uses.html)
+* [NameForms](4.1.1.8-name-forms.html)
+* [ApacheDS Schema Elements](4.1.1.9-apacheds-schema-elements.html)
+
+# Introduction
+
+LDAP defines 8 different Schema Objects, that are used to define what we can store in a LDAP server, how what we store is organized, and which constraints are applied on those elements.
+
+In the API, we also define 3 other **SchemaObjects**, which are necessary to control the values and to compare them. They are hard coded, and can be extended if needed.
+
+## The Schema Object list
+
+Here are the 8 LDAP **SchemaObject**s and the 3 additional ones :
+
+| Name | Description |
+|---|---|
+| **[ObjectClasses (e)](4.8-object-classes.html)** | Defines the permitted **AttributeType**s of an entry |
+| **[AttributeTypes (...)](4.2-attribute-types.html)** | Defines the type of attributes we can store in an entry |
+| **[Syntaxes (e)](4.9-syntaxes.html)** | Defines the syntax that is applied to the **AttributeType** values |
+| **[MatchingRules (e)](4.5-matching-rules.html)** | The rules that are used to match **AttributeType**'s values |
+| **[DITContentRules (e)](4.3-dit-content-rules.html)** | Defines the allowed or forbidden **AttributeType**s and **ObjectClasse**s |
+| **[DITStructureRules (e)](4.4-dit-structure-rules.html)** | Defines the hierarchical relationships between entries |
+| **[NameForms (e)](4.7-name-forms.html)** | Defines the **AttributeType**s that may be use in a **RDN** |
+| **[MatchingRuleUses (e)](4.6-matching-rule-uses.html)** | Defines the **AttributeType**s that can be used for a **MatchingRule** |
+| _**[SyntaxChecker (e)]()**_ | The function that do the check on values |
+| _**[Normalizer (e)]()**_ | The function that normalize the values |
+| _**[LdapComparator (e)]()**_ | The function that compare two values |
+
+The last three elements are ApacheDS specific.
+
+All those elements have some tight relationships. The following schema expose all the relations between all those elements :
+
+
+
+## Java Class hierarchy
+
+Here is the relation between the various Java classes that are implementing the various **SchemaObject**s elements :
+
+
+
+As we can see, the 3 specific **SchemaObject**s are derived from a **LoadableSchemaObject** abstract class, which allows the developper to inject a new instance of one of those 3 **SchemaObject**s.
+
+From teh developper point of view, the interesting methods are the following :
+
+* equals() : checks that two **SchemaObject** instances are equals
+* getDescription() : gets the DESC part of the **SchemaObject**
+* getExtension(String) : gets the given extension (X-abc)
+* getExtensions() : gets all the extensions for this **SchemaObject**
+* getName() : gets the first name fo this **SchemaObject**
+* getNames() : gets all the nales for this **SchemaObject**
+* getObjectType() : gets the **SchemaObject** type
+* getOid() : gets the **SchemaObject** OID
+* getSchemaName() : gets the associated shcema name, if any
+* getSpecification() : gets the OpenLDAP synatx specification for this **SchemaObject**
+* hasExtension(String) : tells if this **SchemaObject** has some extensions
+* isDisabled() : tells if this **SchemaObject** is disabled
+* isEnabled() : tells if this **SchemaObject** is enabled
+* isObsolete() : tells if this **SchemaObject** is obsolete and should not been used
+* isReadOnly() : tells if this **SchemaObject** can't be modified
+
+All those methods are available for all the **SchemaObject**. There are specific methods available for each specific **SchemaObject**, taht will be exposed in the dedicated pages.
Added: directory/site/trunk/content/api/user-guide/4.1.1.1-attribute-types.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.1-attribute-types.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.1-attribute-types.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.1-attribute-types.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,79 @@
+Title: 4.1.1.1 - AttributeTypes
+NavPrev: 4.1.1-schema-objects.html
+NavPrevText: 4.1.1 - Schema Objects
+NavUp: 4.1.1-schema-object.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.1.2-object-classes.html
+NavNextText: 4.1.1.2 - ObjectClasses
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.1 - AttributeTypes
+
+The **AttributeType** **SchemaObject** expose some extra parameters. Here is the description as found in RFC 4512 :
+
+ 4.1.2. Attribute Types
+
+ Attribute Type definitions are written according to the ABNF:
+
+ AttributeTypeDescription = LPAREN WSP
+ numericoid ; object identifier
+ [ SP "NAME" SP qdescrs ] ; short names (descriptors)
+ [ SP "DESC" SP qdstring ] ; description
+ [ SP "OBSOLETE" ] ; not active
+ [ SP "SUP" SP oid ] ; supertype
+ [ SP "EQUALITY" SP oid ] ; equality matching rule
+ [ SP "ORDERING" SP oid ] ; ordering matching rule
+ [ SP "SUBSTR" SP oid ] ; substrings matching rule
+ [ SP "SYNTAX" SP noidlen ] ; value syntax
+ [ SP "SINGLE-VALUE" ] ; single-value
+ [ SP "COLLECTIVE" ] ; collective
+ [ SP "NO-USER-MODIFICATION" ] ; not user modifiable
+ [ SP "USAGE" SP usage ] ; usage
+ extensions WSP RPAREN ; extensions
+
+ usage = "userApplications" / ; user
+ "directoryOperation" / ; directory operational
+ "distributedOperation" / ; DSA-shared operational
+ "dSAOperation" ; DSA-specific operational
+
+The follwing methods have been added to cover the ones that are not already present in the **SchemaObject** interface :
+
+* getEquality() : returns the **MatchingRule** instance used to control the equality of the **AttributeType**
+* getEqualityName() : returns the name of the EQUALITY **MatchingRule**.
+* getEqualityOid() : returns the OID of the EQUALITY **MatchingRule**.
+* getOrdering() : returns the **MatchingRule** instance used to control the ordering of the *AttributeType**
+* getOrderingName() : returns the name of the ORDERING **MatchingRule**.
+* getOrderingOid() : returns the OID of the ORDERING **MatchingRule**.
+* getSubstring() : returns the **MatchingRule** instance used to match a substring from the **AttributeType**
+* getSubstringName() : returns the name of the SUBSTR **MatchingRule**.
+* getSubstringOid() : returns the OID of the SUBSTR **MatchingRule**.
+* getSuperior() : returns the **AttributeType** instance that this instance inherits from
+* getSuperiorName() : returns the superior **AttributeType**'s name
+* getSuperiorOid() : returns the superior **AttributeType**'s OID
+* getSyntax() : returns the associated **LdapSyntax** instance (or the parent's **AttributeType**'s one)
+* getSyntaxLength() : returns the maximum length for the **AttributeType** value
+* getSyntaxName() : returns the associated **LdapSyntax** instance's name
+* getSyntaxOid() : returns the associated **LdapSyntax** instance's OID
+* getUsage() : returns the usage (one of (USER_APPLICATIONS, DIRECTORY_OPERATION, DISTRIBUTED_OPERATION and DSA_OPERATION)
+* isAncestorOf(AttributeType) : tells if the **AttributeType** is the superior of another one
+* isCollective() : tells if the **AttributeType** is a collective attribute
+* isDescendantOf(AttributeType)
+* isOperational() : tells if the **AttributeType** is an operational attribute (one of DIRECTORY_OPERATION, DISTRIBUTED_OPERATION and DSA_OPERATION)
+* isSingleValued() : tells if the **AttributeType** only accept single values
+* isUser() : tells if the **AttributeType** is a USER_APPLICATIONS attribute
+* isUserModifiable() : tells if the **AttributeType** is modifiable or not
Added: directory/site/trunk/content/api/user-guide/4.1.1.2-object-classes.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.2-object-classes.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.2-object-classes.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.2-object-classes.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.1.2 - ObjectClasses
+NavPrev: 4.1.1.1-attribute-types.html
+NavPrevText: 4.1.1.1 - AttributeTypes
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.2.3-syntaxes.html
+NavNextText: 4.1.1.3 - Syntaxes
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.2 - ObjectClasses
Added: directory/site/trunk/content/api/user-guide/4.1.1.3-syntaxes.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.3-syntaxes.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.3-syntaxes.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.3-syntaxes.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,43 @@
+Title: 4.1.1.3 - Syntaxes
+NavPrev: 4.1.1.2-object-classes.html
+NavPrevText: 4.1.1.2 - ObjectClasses
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.1.4-matching-rules.html
+NavNextText: 4.1.1.4 - MatchingRules
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.3 - Syntaxes
+
+The **LdapSyntax** class implements the LDAP **Syntax**s schema objects. A **Syntax** defines a constraints applied to the **AttributeType** value. Here is the TFC description of a **Syntax** :
+
+ SyntaxDescription = LPAREN WSP
+ numericoid ; object identifier
+ [ SP "DESC" SP qdstring ] ; description
+ extensions WSP RPAREN ; extensions
+
+The important part of the **Syntax** is its **OID** which is used in the **AttributeType** and **MatchingRule**.
+
+In order to enforce a **Syntax**, the **LDAP API** is associated with a **SyntaxChecker**, which is a Java class (see the chapter about ApacheDS Schema Elements).
+
+## Methods
+
+The two important methods you might use are :
+
+* getSyntaxChecker() : retreive the associated class that is used to check a syntax
+* isHumanReadable() : tells if the AttributeType is a String or a byte[]
Added: directory/site/trunk/content/api/user-guide/4.1.1.4-matching-rules.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.4-matching-rules.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.4-matching-rules.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.4-matching-rules.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,43 @@
+Title: 4.1.1.4 - MatchingRules
+NavPrev: 4.1.1.3-syntaxes.html
+NavPrevText: 4.1.1.3 - Syntaxes
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.1.5-dit-content-rules.html
+NavNextText: 4.1.1.5 - DITContentRules
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.4 - MatchingRules
+
+A **MatchingRule** is used when processing a search **Filter** evaluation, or a **Compare** or **Modify** operation. An **AttributeType** can define up to 3 types of **MatchingRule** :
+
+* EQUALITY
+* ORDERING
+* SUBSTR
+
+There are a few extra parameter that are defined in the **MatchingRule** class :
+
+* getSyntax() : gets the **Syntax** instance associated with the **MatchingRule**
+* getSyntaxOid() : gets the **Syntax** OID associated with the **MatchingRule**
+
+We also have 2 specific methods that are used to compare or normalize a value :
+
+* getLdapComparator() : gets the **LdapComparator** to use to compare 2 values
+* getNormalizer() : gets the **Normalizer** used to normalize a value
+
+Those are convenient methods, specifically when you will need to compare two values.
Added: directory/site/trunk/content/api/user-guide/4.1.1.5-dit-content-rules.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.5-dit-content-rules.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.5-dit-content-rules.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.5-dit-content-rules.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.1.5 - DitContentRules
+NavPrev: 4.1.1.4-matching-rules.html
+NavPrevText: 4.1.1.4 - MatchingRules
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - SchemaO bjects
+NavNext: 4.1.6-dit-structure-rules.html
+NavNextText: 4.1.6 - DitStructureRules
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.5 - DitContentRules
Added: directory/site/trunk/content/api/user-guide/4.1.1.6-dit-structure-rules.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.6-dit-structure-rules.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.6-dit-structure-rules.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.6-dit-structure-rules.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.1.6 - DitStructureRules
+NavPrev: 4.1.1.5-dit-content-rules.html
+NavPrevText: 4.1.1.5 - DitContentRules
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.1.7-matching-rule-uses.html
+NavNextText: 4.1.1.7 - MatchingRuleUses
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.6 - DitStructureRules
Added: directory/site/trunk/content/api/user-guide/4.1.1.7-matching-rule-uses.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.7-matching-rule-uses.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.7-matching-rule-uses.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.7-matching-rule-uses.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,27 @@
+Title: 4.1.1.7 - MatchingRuleUses
+NavPrev:
+NavPrevText:
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext:
+NavNextText:
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.7 - MatchingRuleUses
+
+
Added: directory/site/trunk/content/api/user-guide/4.1.1.8-name-forms.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.8-name-forms.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.8-name-forms.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.8-name-forms.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.1.8 - NameForms
+NavPrev: 4.1.1.7-matching-rule-use.html
+NavPrevText: 4.1.1.7 - Matching Rule Uses
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.1.9-apacheds-schema-eleemnts.html
+NavNextText: 4.1.1.9 - ApacheDS Schema Elements
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.8 - NameForms
Added: directory/site/trunk/content/api/user-guide/4.1.1.9-apacheds-schema-elements.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.1.9-apacheds-schema-elements.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.1.9-apacheds-schema-elements.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.1.9-apacheds-schema-elements.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.1.9 - ApacheDS Schema Element
+NavPrev: 4.1.1.8-name-forms.html
+NavPrevText: 4.1.1.8 - Name Forms
+NavUp: 4.1.1-schema-objects.html
+NavUpText: 4.1.1 - Schema Objects
+NavNext: 4.1.2-registries.html
+NavNextText: 4.1.2 - Registries
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.1.9 - AapcheDS Schema Element
Added: directory/site/trunk/content/api/user-guide/4.1.2-registries.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.2-registries.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.2-registries.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.2-registries.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.2 - Registries
+NavPrev: 4.1.1-schema-object.html
+NavPrevText: 4.1.1 Schema Objects
+NavUp: 4.1-schema-manager.html
+NavUpText: 4.1 - Schema Manager
+NavNext: 4.1.3-schema-loader.html
+NavNextText: 4.1.3 - Schema Loader
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.2 - Registries
Added: directory/site/trunk/content/api/user-guide/4.1.3-schema-loader.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/4.1.3-schema-loader.mdtext?rev=1703910&view=auto
==============================================================================
--- directory/site/trunk/content/api/user-guide/4.1.3-schema-loader.mdtext (added)
+++ directory/site/trunk/content/api/user-guide/4.1.3-schema-loader.mdtext Fri Sep 18 19:04:01 2015
@@ -0,0 +1,25 @@
+Title: 4.1.3 - SchemaLoader
+NavPrev: 4.1.2-registries.html
+NavPrevText: 4.1.2 - Registries
+NavUp: 4.1-schema-manager.html
+NavUpText: 4.1 - Schema Manager
+NavNext: 5-ldap-security.html
+NavNextText: 5 - LDAP Security
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# 4.1.3 - SchemaLoader