Release Notes for ModeShape 2.5.0.Beta2

ModeShape 2.5.0.Beta2 includes several new minor improvements and changes since 2.5.0.Beta1, including:

• upgrades of several third-party dependencies
• smaller JAR files (no longer dependent upon Google Collections or the JCIP libraries)
• versioning-related fixes and performance improvements
• about twenty bug fixes

The 2.5.0.Beta1 release included:

• new javax.jcr.Credentials classes for anonymous and HTTP servlet authentication
• a built-in profiling framework enabling use of Byteman runtime bytecode injection
• refactored the build process, which now uses Maven 3
• switch to PicketBox for the JAAS implementation used in unit tests
• performance improvements
• almost two dozen bug fixes

JCR Supported Features

ModeShape implements all of the required JCR 2.0 features (repository acquisition, authentication, reading/navigating, query, export, node type discovery, and permissions and capability checking) and most of the optional JCR 2.0 features (writing, import, observation, workspace management versioning, locking, node type management, same-name siblings, shareable nodes, and orderable child nodes). The remaining optional features in JCR 2.0 (access control management, lifecycle management, retention and hold, and transactions) may be introduced in future versions.

ModeShape supports the JCR-SQL2 and JCR-QOM query languages defined in JSR-283, plus the XPath and JCR-SQL languages defined in JSR-170 but deprecated in JSR-283. ModeShape also supports a simple search-engine-like language that is actually just the full-text search expression grammar used in the second parameter of the CONTAINS(...) function of the JCR-SQL2 language.

The 2.5.0.Beta2 release has not yet been certified to be fully compliant with JCR 2.0. The ModeShape project plans to focus on attaining this certification in the very near future.

Accessing the Repository

• JAAS Authentication
• HTTP Authentication (for RESTful and WebDAV Services Only)
• Custom Authentication

Namespaces

• Session Remapping
• Permanent Addition/Deletion

Reading Repository Content

• Traversal Access
• Direct Access
• Same-Name Siblings
• Multi-Value Properties
• All Property Types Supported
• Property Type Conversion

Writing Repository Content

• Create/Update/Delete Nodes
• Create/Update/Delete Properties (Through Parent Nodes)
• Moving, Copying, Cloning
• Adding/Removing Mixins
• Referential integrity enforcement

Query / Search

• XPath
• JCR-SQL
• JCR-SQL2
• JCR-QOM
• Full-Text Search

Importing/Exporting Repository Content

• System View Import/Export
• Document View Import/Export

Node Types

• Inheritance Among Node Types
• Discovering available Node Types
• Discovering the Node Types of a Node
• Discovering the Definition of a Node Type
• Property Constraints
• Automatic Item Creation
• Predefined standard Node Types
• Custom Node Type Registration (CND-Based and and JCR 2.0 API Template-Based)

Repository Metadata under System Node

• Permanent Namespace Mappings
• Node Types (Built-In and User-Registered)
• Active Locks

Other JCR Optional Features

• Locking
• Observation
• Versioning
• Shareable Nodes

Connectors, Sequencers, and Other Features

As with previous releases, ModeShape 2.5.0.Beta2 integrates with JAAS, web application security, or you can easily integrate it with other systems. ModeShape can use a variety of back-ends to store information (RDBMSes, Infinispan data grid, memory, JBoss Cache, JCR repositories), can access content in multiple systems (file systems, SVN repositories, JDBC metadata), can federate multiple stores and systems into a single JCR repository, or can access other systems using custom connectors. ModeShape is also able to automatically extract and store useful content from files you upload into the repository using its library of sequencers, making that information much more accessible and searchable than if it remains locked up inside the stored files. And ModeShape provides WebDAV and RESTful services to allow various clients to access the content. For details, see the Reference Guide.

Connectors

• Federated Connector
• JPA Connector (read-write/persistent storage)
• In-Memory Connector (read-write)
• JCR Connector (read-write)
• Infinispan Connector (read-write/persistent storage)
• JBoss Cache Connector (read-write/persistent storage)
• File System Connector (read-write/persistent storage of files & folders)
• Subversion Connector (read-write/persistent storage of files & folders)
• JDBC Metadata Connector (read-only)

Sequencers

• Compact Node Definition (CND) Sequencer
• DDL Sequencer
• Image Sequencer
• Java Source Sequencer
• Java Class Sequencer
• MP3 Sequencer
• MS Office Sequencer
• Text Sequencers (Delimited and Fixed Width)
• XML Sequencer
• Zip File Sequencer (also WARs, JARs, and EARs)
• Teiid Relational Model Sequencer
• Teiid VDB Sequencer

Deployment/Access Models

• Clustering
• JNDI-Based Deployment
• Embedded (in Server or JEE Archive) Deployment
• OSGi-Compatible Archives
• Access through RESTful Service
• Access through WebDAV Service
• Deploy as a service in JBoss Application Server, with JOPR monitoring
• JDBC driver for accessing ModeShape content through JDBC API and JCR-SQL2 queries

Bug Fixes, Features, and other Issues

Bug

• MODE-1089 - PathNotFoundException when trying to checkin a node.
• MODE-1144 - RepositoryException: Table 'nodeSet2' does not exist
• MODE-1145 - JCR-SQL2 Query is returning an error for properties referenced that are not in the NodeTypeDefinition
• MODE-1146 - REST Servlet Ignores Servlet Mappings Other Than /*
• MODE-1141 - VersionManager.checkin(...) descends below any versionable nodes within that subgraph
• MODE-1140 - Maven build is not running older JUnit 3 unit tests (e.g., the TCK unit tests)
• MODE-1137 - Importing and/or exporting Unicode characters results in exceptions
• MODE-1130 - Unable To Use Versioning When Publishing Files Using REST Client
• MODE-1131 - Exception Querying For Workspace Areas Using IRestClient
• MODE-1154 - RepositoryNodeTypeManager allows NodeTypes to be updated, but JcrNodeTypeManager does not pass through allowUpdate
• MODE-1152 - Repositories example requires HSQLDB
• MODE-1136 - Lock and unlock requests are not being batched correctly
• MODE-1139 - javax.jcr.nodetype.ConstraintViolationException is wrapped by org.modeshape.jcr.JcrContentHandler.EnclosingSAXException

Component Upgrade

• MODE-1143 - Upgrade to Lucene 3.1

Enhancement

• MODE-1153 - Move examples to its own git repository
• MODE-1151 - Examples should use Logback for logging

Feature Request

• MODE-1147 - Add support in CND parser for vendor extensions
• MODE-1122 - Option to allow sessions to use anonymous privileges when JAAS authentication fails
• MODE-1135 - Add ability to define and call functions in Requests in the graph/connector framework
• MODE-1138 - Value constraint violation message

Task

• MODE-1108 - Add compilation support in for JDK 1.5 for downstream projects
• MODE-1128 - Remove dependency on JCIP
• MODE-1125 - Ignore .classpath and .project and remove it from projects
• MODE-1142 - Clean up inconsistent @Override annotations

Sub-task

• MODE-1134 - Versioning operations use system graph inefficiently