org.apache.chemistry.opencmis.client.api chemistry-opencmis-client-api Main interfaces of the client API

Transcription

1 OpenCMIS Client API OpenCMIS Client API Table of Content OpenCMIS Client API Sessions Example Code Session Creation - AtomPub Binding Session Creation - Web Services Binding Reading Objects - Root Collection Reading Properties - Single Property Reading Properties - All Properties The OpenCMIS client layer provides an object oriented interface for easy consumption of the underlying CMIS related layers. In addition to the CMIS specification the OpenCMIS client layer introduces a session concept which easily enables applications to get control on the client side cache behavior. The client layer consists of a client interface, common interfaces and a runtime implementation. The runtime maps the client interface to the bindings layer and implements the session cache. All parts are exposed by following packages: Package Artifact Description org.apache.chemistry.opencmis.client.api chemistry-opencmis-client-api Main interfaces of the client API org.apache.chemistry.opencmis.commons.api chemistry-opencmis-commons-api Interfaces and classes shared by client and client bindings API org.apache.chemistry.opencmis.client.runtime chemistry-opencmis-client-impl Implementation classes of client API including a default implementation of the SessionFactory The following UML diagram illustrates the main classes of the client API:

2 SessionFactory This interface provides the entry point into the client API and is responsible to create a session object. Additionally it gives access to all repository info exposed by a CMIS client binding. The runtime provides a default implementation for the SessionFactory interface. Session This is the main interface an application has to work with. A session object is related to a CMIS service client binding and is attached to exact one repository. All data that is received through the session interface can be cached in the session object in dependency of the concrete implementation which is behind. Repository Wrapper interface for the CMIS RepositoryInfo service. CmisObject The CmisObject interface represents the CMIS domain object. ObjectType This interface is base for all CMIS domain types like FolderType, DocumentType, PolicyType and RelationshipType. The derived interfaces are not shown in the diagram. Folder This interface represents the CMIS folder object. Document This interface represents the CMIS document object. ContentStream this interface wraps the content stream of a CMIS document. Policy This interface represents the CMIS policy object. Relationship This interface represents the CMIS relationship object. Sessions OpenCMIS' central entry point to a CMIS repository is a session. A session controls settings and caches that used across multiple calls and provides access to all CMIS operations and objects. In order to create a session, the SessionFactory needs a set parameters (see OpenCMIS Session Parameters). Example Code Session Creation - AtomPub Binding

3 Opening a Atom Pub Connection // default factory implementation of client runtime SessionFactory f = SessionFactoryImpl.newInstance(); Map<String, String> parameter = new HashMap<String, String>(); // user credentials parameter.put(sessionparameter.user, "Otto"); parameter.put(sessionparameter.password, "****"); // connection settings parameter.put(sessionparameter.atompub_url, " /atom"); parameter.put(sessionparameter.binding_type, BindingType.ATOMPUB.value()); parameter.put(sessionparameter.repository_id, "myrepository"); // session locale parameter.put(sessionparameter.locale_iso3166_country, ""); parameter.put(sessionparameter.locale_iso639_language, "de"); // create session Session s = f.createsession(parameter); Session Creation - Web Services Binding

4 Opening a Web Services Connection // default factory implementation of client runtime SessionFactory f = SessionFactoryImpl.newInstance(); Map<String, String> parameter = new HashMap<String, String>(); // user credentials parameter.put(sessionparameter.user, "Otto"); parameter.put(sessionparameter.password, "****"); // connection settings parameter.put(sessionparameter.binding_type, BindingType.WEBSERVICES. value()); parameter.put(sessionparameter.repository_id, "myrepository"); parameter.put(sessionparameter.webservices_acl_service, " <port>/cmis/services/aclservice?wsdl"); parameter.put(sessionparameter.webservices_discovery_service, " parameter.put(sessionparameter.webservices_multifiling_service, " parameter.put(sessionparameter.webservices_navigation_service, " parameter.put(sessionparameter.webservices_object_service, " <port>/cmis/services/objectservice?wsdl"); parameter.put(sessionparameter.webservices_policy_service, " <port>/cmis/services/policyservice?wsdl"); parameter.put(sessionparameter.webservices_relationship_service, " parameter.put(sessionparameter.webservices_repository_service, " parameter.put(sessionparameter.webservices_versioning_service, " // session locale parameter.put(sessionparameter.locale_iso3166_country, ""); parameter.put(sessionparameter.locale_iso639_language, "de"); parameter.put(sessionparameter.locale_variant, ""); // create session Session s = f.createsession(parameter); Reading Objects - Root Collection

5 Reading the Root Collection Folder root = this.session.getrootfolder(); ItemIterable<CmisObject> pl = root.getchildren(); for (CmisObject o : pl) { System.out.println(o.getName()); } Reading Properties - Single Property Reading a Single Property ObjectId id = this.session.createobjectid("4711"); Document document = (Document) this.session.getobject(id); Property<String> p = document.getproperty(propertyids.object_id); String s = p.getvalue(); Reading Properties - All Properties Reading all Properties ObjectId id = this.session.createobjectid("4711"); Document document = (Document) this.session.getobject(id); List<Property<?>> l = document.getproperties(); Iterator<Property<?>> i = l.iterator(); while (i.hasnext()) { Property<?> p = i.next(); Object value = p.getvalue(); PropertyType t = p.gettype(); } switch (t) { case INTEGER: Integer n = (Integer) value; System.out.println(p.getName() + " = " + n); break; case STRING: [...]