cmis 0.1.0-java

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+TODO.txt
+
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cmis.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Richard Nyström
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,212 @@
+# CMIS
+
+CMIS client for JRuby. This gem uses the Apache Chemistry OpenCMIS Java libraries under the hood.
+
+More information about Apache Chemistry can be found here: http://chemistry.apache.org/
+
+## What is CMIS
+
+Content Management Interoperability Services (CMIS) is an open standard that defines an abstraction layer for controlling diverse document management systems and repositories using web protocols. CMIS defines a domain model plus Web Services and Restful AtomPub (RFC5023) bindings that can be used by applications.
+
+Here are a few CMIS-compliant content repositories:
+
+* [Alfresco](http://www.alfresco.com)
+* [Nuxeo](http://www.nuxeo.com)
+* [EMC Documentum](http://www.emc.com/domains/documentum/index.htm)
+* [Sharepoint](http://sharepoint.microsoft.com/en-us/Pages/default.aspx)
+* [IBM FileNet Content Manager](http://www-01.ibm.com/software/data/content-management/filenet-content-manager/)
+* [KnowledgeTree](https://www.knowledgetree.com/)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cmis'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cmis
+
+## Usage
+
+This guide is for JRuby developers who want to access CMIS-compliant content repositories from JRuby. The examples has been tested with Alfresco Community Edition 4.2.c which is one of the most feature complete CMIS content repository.
+
+If you want to run the code snippets below you can download and install Alfresco. You can find the version that fits your platform here: http://wiki.alfresco.com/wiki/Download_and_Install_Alfresco
+
+You can also run the examples using the Public Alfresco CMIS server. More information can be found here: http://cmis.alfresco.com. The atom url for the public 
+server is http://cmis.alfresco.com/cmisatom.
+
+Nuxeo also provides a demo server. More information can be found here: http://doc.nuxeo.com/display/NXDOC/CMIS+for+Nuxeo#CMISforNuxeo-Onlinedemo .
+
+## Connecting to a CMIS repository
+
+To be able to do anything useful on a CMIS repository, you must first find a repository, and create a session with it:
+
+```ruby
+require 'cmis'
+atom_url = "http://localhost:8080/alfresco/service/cmis"
+user = "admin"
+password = "admin"
+@session = CMIS::create_session(atom_url, user, password)
+
+```
+Most CMIS servers only provides one repository by default that you can connect to and the code above automatically connects to the first repository that it finds.
+If you want to connect to a specific repository you can do it like this:
+
+```ruby
+available_repos = CMIS::repositories(atom_url, user, password)
+puts "Trying to connect to a repository with id #{available_repos[0].id}"
+@session = CMIS::create_session(atom_url, user, password, available_repos[0].id)
+
+```
+
+## Working with folders and documents
+
+Finding the contents of the root folder:
+
+```ruby
+root = @session.root_folder
+children = root.children
+
+# Prints out all children objects name found in the root folder
+children.each do |o|
+  puts o.name
+end
+```
+
+### Creating folders
+
+Create a folder the simple way. The create_cmis_folder method is a convenient method implemented in the JRuby CMIS library.
+
+```ruby
+root.create_cmis_folder("My new folder")
+```
+
+Create a folder the hard way:
+
+```ruby
+folder_props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:folder", CMIS::PropertyIds::NAME => "Another folder" }
+root.create_folder(folder_props)
+```
+
+### Creating/Uploading documents
+
+The create_cmis_document method is a convenient method implemented in the JRuby CMIS Library.
+This method takes a name and a file path and uploads the file to the repository. The document will be saved as a major version.
+
+```ruby
+id = root.create_cmis_document("cmis_logo.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts doc.name
+```
+
+#### Create a document the hard way (but with more flexibility)
+
+```ruby
+content_stream = CMIS::create_content_stream("/Users/ricn/cmis_logo.png", @session)
+props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:document", CMIS::PropertyIds::NAME => "cmis_logo.png" }
+id = root.create_document(props, content_stream, CMIS::VersioningState::MAJOR)
+doc = @session.get_object(id)
+```
+
+#### Download a document to your local disk
+
+```ruby
+doc = @session.get_object(id)
+file = "/Users/ricn/" + doc.name
+doc.download(file)
+```
+
+### Updating a document
+
+```ruby
+id = root.create_cmis_document("cmis_logo_original.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts "Original name: #{doc.name}"
+props = { CMIS::PropertyIds::NAME => "cmis_logo_renamed.png"}
+id = doc.update_properties(props)
+doc = @session.get_object(id)
+puts "New name: #{doc.name}"
+```
+
+### Deleting a document
+
+```ruby
+doc = @session.get_object(id)
+doc.delete # Yay, that was easy!
+```
+
+### Deleting a folder tree
+
+```ruby
+# First we need to create a folder tree
+folder1 = root.create_cmis_folder("folder1")
+folder11 = folder1.create_cmis_folder("Folder11")
+folder12 = folder1.create_cmis_folder("Folder12")
+# Delete it
+folder1.delete_tree(true, CMIS::UnfileObject::DELETE, true) # parameter explanation: boolean allversions, UnfileObject unfile, boolean continueOnFailure
+```
+
+## Working with CMIS Properties
+
+```ruby
+### Displaying the properties of an object
+props = @session.root_folder.properties
+props.each do |p|
+  display_name = p.definition.display_name
+  value = p.value_as_string
+  if display_name != nil && value != nil
+    puts p.definition.display_name + ": " + p.value_as_string
+  end
+end
+```
+
+### Getting a property explicitly
+
+Each object type has a known set of properties, and you can retrieve these explicitly. For example, the document type has a set of properties described by the [DocumentProperties](http://chemistry.apache.org/java/0.8.0/maven/apidocs/org/apache/chemistry/opencmis/client/api/DocumentProperties.html) interface, and you can use the methods on this interface to retrieve the value a property.
+
+```ruby
+# For root folder
+puts "Is root folder? " + root.is_root_folder.to_s
+puts "Path: " + root.path
+
+# For a document
+id = root.create_cmis_document("cmis.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts "Name: " + doc.name
+puts "Version label: " + doc.version_label
+puts "Content stream file name: " + doc.content_stream_file_name
+puts "Content stream mime type: " + doc.content_stream_mime_type
+```
+
+## Working with CMIS Queries
+
+```ruby
+query = "SELECT * FROM cmis:document WHERE cmis:name LIKE 'cmis%'"
+q = @session.query(query, false) # true means search all versions
+
+q.each do |result|
+  puts result.property_value_by_query_name("cmis:name")
+end
+```
+
+## DOCUMENTION TODO:
+* Add Multi-filing and Unfiling examples
+* Add Relationships examples
+* Add Access control examples
+* Add OperationContext examples
+* Add Advanced types usage examples
+* Add Performance notes
+* Add Troubleshooting notes
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+desc 'Download jars'
+task :download_jars do
+	system "mvn dependency:copy-dependencies"
+end

data/cmis.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cmis/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "cmis"
+  gem.version       = Cmis::VERSION
+  gem.authors       = ["Richard Nyström"]
+  gem.email         = ["ricny046@gmail.com"]
+  gem.description   = %q{A thin JRuby wrapper for the Apache Chemistry OpenCMIS client.}
+  gem.summary       = %q{A thin JRuby wrapper for the Apache Chemistry OpenCMIS client.}
+  gem.homepage      = "https://github.com/ricn/cmis"
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.add_development_dependency "rspec"
+  gem.platform = "java"
+end

data/lib/cmis/version.rb

@@ -0,0 +1,3 @@
+module Cmis
+  VERSION = "0.1.0"
+end

data/lib/cmis.rb

@@ -0,0 +1,115 @@
+raise "You need to run JRuby to use CMIS" unless RUBY_PLATFORM =~ /java/
+
+require "cmis/version"
+require 'java' 
+
+Dir[File.join(File.dirname(__FILE__), "../target/dependency/*.jar")].each do |jar|
+  require jar
+end
+
+module CMIS
+  import org.apache.chemistry.opencmis.client.api.Session
+  import org.apache.chemistry.opencmis.client.api.SessionFactory
+  import org.apache.chemistry.opencmis.client.api.OperationContext
+  import org.apache.chemistry.opencmis.client.util.FileUtils
+  import org.apache.chemistry.opencmis.client.runtime.OperationContextImpl
+  import org.apache.chemistry.opencmis.client.runtime.SessionFactoryImpl
+  import org.apache.chemistry.opencmis.commons.SessionParameter
+  import org.apache.chemistry.opencmis.commons.PropertyIds
+  import org.apache.chemistry.opencmis.commons.impl.MimeTypes
+  
+  import org.apache.chemistry.opencmis.commons.enums.Action
+  import org.apache.chemistry.opencmis.commons.enums.BaseTypeId
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityAcl
+  import org.apache.chemistry.opencmis.commons.enums.VersioningState
+  import org.apache.chemistry.opencmis.commons.enums.UnfileObject
+  import org.apache.chemistry.opencmis.commons.enums.BindingType
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityChanges
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityContentStreamUpdates
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityJoin
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityQuery
+  import org.apache.chemistry.opencmis.commons.enums.CapabilityRenditions
+  import org.apache.chemistry.opencmis.commons.enums.Cardinality
+  import org.apache.chemistry.opencmis.commons.enums.ChangeType
+  import org.apache.chemistry.opencmis.commons.enums.ContentStreamAllowed
+  import org.apache.chemistry.opencmis.commons.enums.DateTimeResolution
+  import org.apache.chemistry.opencmis.commons.enums.DecimalPrecision
+  import org.apache.chemistry.opencmis.commons.enums.ExtensionLevel
+  import org.apache.chemistry.opencmis.commons.enums.IncludeRelationships
+  import org.apache.chemistry.opencmis.commons.enums.PropertyType
+  import org.apache.chemistry.opencmis.commons.enums.RelationshipDirection
+  import org.apache.chemistry.opencmis.commons.enums.SupportedPermissions
+  import org.apache.chemistry.opencmis.commons.enums.UnfileObject
+  import org.apache.chemistry.opencmis.commons.enums.Updatability
+
+  FolderImpl = org.apache.chemistry.opencmis.client.runtime.FolderImpl
+  DocumentImpl = org.apache.chemistry.opencmis.client.runtime.DocumentImpl
+  
+  class DocumentImpl
+    def download(destination_path)
+      FileUtils.download(self, destination_path)
+    end
+  end
+  
+  class FolderImpl
+    def create_cmis_folder(name, props = nil)
+      folder_props = { PropertyIds::OBJECT_TYPE_ID => "cmis:folder", PropertyIds::NAME => name }
+      folder_props.merge!(props) if props != nil && props.is_a?(Hash)
+      self.create_folder(java.util.HashMap.new(folder_props))
+    end
+
+    def create_cmis_document(name, filename, props = nil)
+      if filename != nil && filename.length > 0
+        file = java.io.File.new(filename)
+        stream = java.io.BufferedInputStream.new(java.io.FileInputStream.new(file))
+        content = session.object_factory.create_content_stream(file.name, file.length, CMIS::MimeTypes.getMIMEType(file), stream)
+        doc_props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:document", CMIS::PropertyIds::NAME => name }
+        doc_props.merge!(props) if props != nil && props.is_a?(Hash)
+        self.create_document(doc_props, content, CMIS::VersioningState::MAJOR)
+      end
+    end
+
+    def create_text_doc(name, content)
+      FileUtils.create_text_document(self.id, name, content, "cmis:document", CMIS::VersioningState::MAJOR, session)
+    end
+  end
+
+  def self.create_session(url, user, password, repo_id = nil)
+      session_factory = SessionFactoryImpl.new_instance
+      repo_id = self.repositories(url, user, password)[0].id if repo_id == nil
+      
+      parameters = { 
+        SessionParameter::ATOMPUB_URL => url,
+        SessionParameter::BINDING_TYPE => BindingType::ATOMPUB.value,
+        SessionParameter::USER => user,
+        SessionParameter::PASSWORD => password,
+        SessionParameter::REPOSITORY_ID => repo_id
+      }
+
+      session_factory.create_session(parameters)
+  end
+
+  def self.repositories(url, user, password)
+    session_factory = SessionFactoryImpl.new_instance
+      parameters = { 
+        SessionParameter::ATOMPUB_URL => url,
+        SessionParameter::BINDING_TYPE => BindingType::ATOMPUB.value,
+        SessionParameter::USER => user,
+        SessionParameter::PASSWORD => password
+      }
+
+    session_factory.get_repositories(parameters)
+  end
+
+  def self.create_content_stream(filename, session)
+    content = nil
+
+    if filename != nil && filename.length > 0
+      file = java.io.File.new(filename)
+      stream = java.io.BufferedInputStream.new(java.io.FileInputStream.new(file))
+      content = session.object_factory.create_content_stream(file.name, file.length, CMIS::MimeTypes.getMIMEType(file), stream)
+    end
+
+    content
+  end
+end

data/pom.xml

@@ -0,0 +1,19 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <name>CMIS</name>
+  
+  <groupId>org.cmis</groupId>
+  <artifactId>CMIS</artifactId>
+  <version>1.0-SNAPSHOT</version>
+  <packaging>jar</packaging>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.apache.chemistry.opencmis</groupId>
+      <artifactId>chemistry-opencmis-client-impl</artifactId>
+      <version>0.8.0</version>
+    </dependency>
+  </dependencies>
+</project>

data/samples.rb

@@ -0,0 +1,112 @@
+require 'cmis'
+
+## Connecting to a CMIS repository (the simple way)
+# To be able to do anything useful on a CMIS repository, you must first find a repository, and create a session with it:
+
+atom_url = "http://localhost:8181/alfresco/service/cmis"
+user = "admin"
+password = "admin"
+@session = CMIS::create_session(atom_url, user, password)
+
+# Most CMIS servers only provides one repository by default that you can connect to and the code above automatically connects to the first repository that it finds.
+# If you want to connect to a specific repository you can do it like this:
+
+available_repos = CMIS::repositories(atom_url, user, password)
+puts "Trying to connect to repository with id #{available_repos[0].id}"
+@session = CMIS::create_session(atom_url, user, password, available_repos[0].id)
+
+## Working with folders and documents
+
+### Finding the contents of the root folder
+
+root = @session.root_folder
+children = root.children
+
+children.each do |o|
+  puts o.name # Prints out all children objects found in the root folder 
+end
+
+### Creating folders
+
+# Create a folder the simple way. This is a convenient method implemented in the JRuby CMIS library.
+root.create_cmis_folder("My new folder")
+
+# Create a folder the hard way:
+folder_props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:folder", CMIS::PropertyIds::NAME => "Another folder" }
+root.create_folder(folder_props)
+
+## Creating/Uploading documents
+
+### Create a document object the simple way. This is a convenient method implemented in the JRuby CMIS Library.
+
+# This method takes a name and a file path and uploads the file to the repository. The document will be saved as a major version.
+id = root.create_cmis_document("cmis_logo.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts doc.name
+
+### Create a document object the hard way:
+# TODO
+
+### Download a document to your local disk:
+# TODO
+
+### Updating a document
+id = root.create_cmis_document("cmis_logo_original.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts "Original name: #{doc.name}"
+props = { CMIS::PropertyIds::NAME => "cmis_logo_renamed.png"}
+id = doc.update_properties(props)
+doc = @session.get_object(id)
+puts "New name: #{doc.name}"
+
+### Deleting a document
+doc = @session.get_object(id)
+doc.delete # Yay, that was easy!
+
+### Deleting a folder tree
+
+# First we need to create a folder tree
+folder1 = root.create_cmis_folder("folder1")
+folder11 = folder1.create_cmis_folder("Folder11")
+folder12 = folder1.create_cmis_folder("Folder12")
+# Delete it
+folder1.delete_tree(true, CMIS::UnfileObject::DELETE, true) # parameter explanation: boolean allversions, UnfileObject unfile, boolean continueOnFailure
+
+## CMIS Properties
+
+### Displaying the properties of an Object
+props = @session.root_folder.properties
+props.each do |p|
+  display_name = p.definition.display_name
+  value = p.value_as_string
+  if display_name != nil && value != nil
+    puts p.definition.display_name + ": " + p.value_as_string
+  end
+end
+
+### Getting a property explicitly
+# Each object type has a known set of properties, and you can retrieve these explicitly.
+# For example, the document type has a set of properties described by the DocumentProperties 
+# (http://chemistry.apache.org/java/0.8.0/maven/apidocs/org/apache/chemistry/opencmis/client/api/DocumentProperties.html) interface, 
+# and you can use the methods on this interface to retrieve the value a property
+
+# For root folder
+puts "Is root folder? " + root.is_root_folder.to_s
+puts "Path: " + root.path
+
+# For a document
+id = root.create_cmis_document("cmis_logo_original.png", "/Users/ricn/cmis_logo.png")
+doc = @session.get_object(id)
+puts "Name: " + doc.name
+puts "Version label: " + doc.version_label
+puts "Content stream file name: " + doc.content_stream_file_name
+puts "Content stream mime type: " + doc.content_stream_mime_type
+
+## Working with CMIS Queries. NOT WORKING :-(
+
+query = "SELECT * FROM cmis:document WHERE cmis:name LIKE 'cmis%'"
+q = @session.query(query, false) # true means search all versions
+
+q.each do |result|
+  puts result.property_value_by_query_name("cmis:name").inspect
+end

data/spec/cmis_spec.rb

@@ -0,0 +1,274 @@
+require 'spec_helper'
+
+describe "CMIS" do
+  shared_examples_for "a CMIS repository" do |atom_url, user, password|
+    
+    before(:all) do
+      @atom_url = atom_url
+      @user = user
+      @password = password
+      @repos = CMIS::repositories(@atom_url, @user, @password)
+      @session = CMIS::create_session(@atom_url, @user, @password, @repos[0].id)
+      @test_folder_name = "JRUBY_CMIS_TEST_" + random_name
+      @test_folder = @session.root_folder.create_cmis_folder(@test_folder_name)
+    end
+
+    after(:all) do
+      @test_folder.delete_tree(true, CMIS::UnfileObject::DELETE, true)
+    end
+
+    describe "Repository functionality" do
+      it "should create a session" do
+        @session.is_a?(Java::OrgApacheChemistryOpencmisClientRuntime::SessionImpl).should be_true
+      end
+    
+      it "should create a session against the first repository" do
+        @simple_session = CMIS::create_session(@atom_url, @user, @password)
+        @simple_session.is_a?(Java::OrgApacheChemistryOpencmisClientRuntime::SessionImpl).should be_true 
+      end
+
+      it "should retrieve all available repositories" do
+        @repos.is_a?(Java::JavaUtil::ArrayList).should be_true
+      end
+
+      it "should have one repository with a name" do
+        repo = @repos[0]
+        repo.name.should_not be_empty
+      end
+
+      it "should be possible to read the repository info" do
+        rep_info = @session.repository_info
+        cap = rep_info.capabilities
+
+        # Just testing a few of them
+        cap.is_get_descendants_supported.should == true
+        cap.is_get_folder_tree_supported.should == true
+        cap.changes_capability.value.should_not be_empty
+        cap.query_capability.value.should_not be_empty
+        cap.join_capability.value.should_not == be_empty
+      end
+    end
+
+    describe "Reading objects" do
+      it "should be possible to find the contents of the root folder" do
+        root = @session.root_folder
+        children = root.children
+        children.map(&:name).should include(@test_folder_name)
+      end
+
+      it "should display the properties of an object" do
+        props = @session.root_folder.properties   
+        props.each do |p|
+          disp_name = p.definition.display_name
+          p.value_as_string.should == "/" if disp_name == "Path"
+          p.value_as_string.should == "cmis:folder" if disp_name == "Type-Id"
+          p.value_as_string.should_not be_nil if disp_name == "Name"
+          p.value_as_string.should be_nil if disp_name == "Parent Id"
+        end
+      end
+
+      it "should be possible to get a property explicitly" do
+        # A couple of folder specific props that we can access explicitly
+        root = @session.root_folder
+        root.is_root_folder.should == true
+        root.path.should == "/"
+      end
+
+      it "should retrieve allowable actions for an object" do
+        allowed_actions = @session.root_folder.allowable_actions.allowable_actions # Are you kidding me!!?
+        allowed_actions.to_a.should include(CMIS::Action::CAN_GET_PROPERTIES)
+      end
+
+      it "should be possible to check if a document is versionable" do
+        doc = create_random_doc(@test_folder)
+        doc.type.is_versionable.should == true
+      end
+
+      it "should be possible to access information about renditions" do
+        file = file_path("document.pdf")
+        file_name = random_name + ".pdf"
+        id = @test_folder.create_cmis_document(file_name, file)      
+        context = @session.create_operation_context
+        context.rendition_filter_string = "cmis:thumbnail"
+        @session.clear
+        doc = @session.get_object(id, context)
+
+        renditions = doc.renditions
+        # TODO: Fix this test.
+        #renditions.size.should >= 1
+        renditions.each do |r|
+          r.kind.should_not be_empty
+          r.mime_type.should_not be_empty
+        end
+      end
+
+      it "should be possible to download document" do
+        doc = create_random_doc(@test_folder)
+        file = Dir.tmpdir + doc.name
+        doc.download(file)
+        File.exists?(file).should == true
+        File.delete(file)
+      end
+    end
+
+    describe "Writing objects" do
+      it "should create a folder" do
+        name = random_name
+        new_folder_props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:folder", CMIS::PropertyIds::NAME => name }
+        @test_folder.create_folder(new_folder_props)
+        @test_folder.children.map(&:name).should include(name)
+      end
+
+      it "should create a folder using convenient method" do
+        name = random_name
+        @test_folder.create_cmis_folder(name)
+        @test_folder.children.map(&:name).should include(name)
+      end
+
+      it "should create document" do
+        content_stream = CMIS::create_content_stream(file_path("text_file.txt"), @session)
+        text_file = random_name + ".txt"
+        props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:document", CMIS::PropertyIds::NAME => text_file }
+        id = @test_folder.create_document(props, content_stream, CMIS::VersioningState::MAJOR)
+        doc = @session.get_object(id)
+    
+        doc.properties.each do |p|
+          p.value.should == 16 if p.definition.id == "cmis:contentStreamLength"
+        end
+      end
+
+      it "should create document using convenient method" do
+        file = file_path("text_file.txt")
+        file_name = random_name + ".txt"
+        id = @test_folder.create_cmis_document(file_name, file)
+        doc = @session.get_object(id)
+
+        doc.properties.each do |p|
+          p.value.should == 16 if p.definition.id == "cmis:contentStreamLength"
+        end
+      end
+
+      it "should create document by specifying a string as content" do
+        content = "Please, save me!"
+        file_name = random_name + ".txt"
+        id = @test_folder.create_text_doc(file_name, content)
+        doc = @session.get_object(id)
+
+        doc.properties.each do |p|
+          p.value.should == content.size if p.definition.id == "cmis:contentStreamLength"
+        end
+      end
+    end
+
+    describe "Updating objects" do
+      it "should rename a document" do
+        doc = create_random_doc(@test_folder)
+        renamed_file_name = "renamed_" + doc.name
+        props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:document", 
+                  CMIS::PropertyIds::NAME => renamed_file_name }
+        doc.update_properties(props)
+
+        doc.name.should == renamed_file_name
+      end
+
+      it "should update the content of a document (versioning)" do
+        doc = create_random_doc(@test_folder)
+    
+        content_stream = CMIS::create_content_stream(file_path("text_file2.txt"), @session)
+        working_copy = @session.get_object(doc.check_out)
+        id = working_copy.check_in(false, nil, content_stream, "minor version")
+        doc = @session.get_object(id)
+      
+        doc.properties.each do |p|
+          p.value.should == 17 if p.definition.id == "cmis:contentStreamLength"
+          p.value.should == "1.1" if p.definition.id == "cmis:versionLabel"
+        end
+
+        versions = doc.all_versions
+        versions.size.should == 2
+      end
+    end
+
+    describe "Deleting objects" do
+      it "should delete a document" do
+        content_stream = CMIS::create_content_stream(file_path("text_file.txt"), @session)
+        text_file = random_name + ".txt"
+        props = { CMIS::PropertyIds::OBJECT_TYPE_ID => "cmis:document",
+                CMIS::PropertyIds::NAME => text_file }
+        id = @test_folder.create_document(props, content_stream, CMIS::VersioningState::MAJOR)
+
+        doc = @session.get_object(id)
+     
+        doc.delete(true)
+        children = @test_folder.children
+        children.map(&:name).should_not include(text_file)
+      end
+
+      it "should delete a folder tree" do
+        root = @test_folder
+        random_folder_name = random_name
+        folder1 = root.create_cmis_folder(random_folder_name)
+        folder11 = folder1.create_cmis_folder("Folder11")
+        folder12 = folder1.create_cmis_folder("Folder12")
+        @test_folder.children.map(&:name).should include(random_folder_name)
+        folder1.delete_tree(true, CMIS::UnfileObject::DELETE, true)
+        @test_folder.children.map(&:name).should_not include(random_folder_name)
+      end
+    end
+
+    describe "Querying and navigating objects" do
+      it "should be possible to navigate through a folder tree" do
+        root = @session.root_folder
+        # just making sure it can be executed
+        root.descendants(-1).count.should > 0 # get folders and documents
+        root.folder_tree(-1).count.should > 0 # get folders only
+      end
+
+      it "should be possible to execute a simple query" do
+        query = "SELECT cmis:name FROM cmis:folder WHERE cmis:name = 'Company Home'"
+        q = @session.query(query, false)
+      
+        q.each do |result|
+          result.get_property_value_by_query_name("cmis:name").should == "Company Home"
+        end
+      end
+
+      it "should be possible to use paging" do
+        @sub_folder = @test_folder.create_cmis_folder("Paging")
+
+        5.times do
+          @sub_folder.create_cmis_folder(random_name)
+        end
+
+        oc = CMIS::OperationContextImpl.new
+        oc.max_items_per_page = 3
+        @sub_folder.children(oc).skip_to(0).page.map(&:name).size.should == 3
+        @sub_folder.children.map(&:name).size.should == 5
+      end
+    end
+  end
+
+  describe "Local Alfresco" do
+    atom_url = "http://localhost:8181/alfresco/service/cmis"
+    user = "admin"
+    password = "admin"
+
+    #it_behaves_like "a CMIS repository", atom_url, user, password
+  end
+
+  describe "Alfresco" do
+    atom_url = "http://cmis.alfresco.com/cmisatom"
+    user = "admin"
+    password = "admin"
+    
+    it_behaves_like "a CMIS repository", atom_url, user, password
+  end
+
+  describe "Nuxeo" do
+    atom_url = "http://cmis.demo.nuxeo.org/nuxeo/atom/cmis"
+    user = "Administrator"
+    password = "Administrator"
+    
+    it_behaves_like "a CMIS repository", atom_url, user, password
+  end
+end

data/spec/fixtures/text_file.txt

@@ -0,0 +1 @@
+This is content.

data/spec/fixtures/text_file2.txt

@@ -0,0 +1 @@
+This is content!!

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+require 'cmis'
+require 'tmpdir'
+def file_path( *paths )
+  File.expand_path(File.join(File.dirname(__FILE__), 'fixtures', *paths))
+end
+
+
+def random_name
+  rand(16**16).to_s(16)
+end
+
+def create_random_doc(parent)
+  file = file_path("text_file.txt")
+  file_name = random_name + ".txt"
+  id = parent.create_cmis_document(file_name, file)
+  
+  parent.session.get_object(id)    
+end
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: cmis
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease:
+platform: java
+authors:
+- Richard Nyström
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2013-01-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MA==
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MA==
+    none: false
+  prerelease: false
+  type: :development
+description: A thin JRuby wrapper for the Apache Chemistry OpenCMIS client.
+email:
+- ricny046@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- cmis.gemspec
+- lib/cmis.rb
+- lib/cmis/version.rb
+- pom.xml
+- samples.rb
+- spec/cmis_spec.rb
+- spec/fixtures/document.pdf
+- spec/fixtures/text_file.txt
+- spec/fixtures/text_file2.txt
+- spec/spec_helper.rb
+- target/dependency/activation-1.1.jar
+- target/dependency/chemistry-opencmis-client-api-0.8.0.jar
+- target/dependency/chemistry-opencmis-client-bindings-0.8.0.jar
+- target/dependency/chemistry-opencmis-client-impl-0.8.0.jar
+- target/dependency/chemistry-opencmis-commons-api-0.8.0.jar
+- target/dependency/chemistry-opencmis-commons-impl-0.8.0.jar
+- target/dependency/jaxb-api-2.1.jar
+- target/dependency/jaxb-impl-2.1.11.jar
+- target/dependency/jaxws-api-2.1.jar
+- target/dependency/jaxws-rt-2.1.7.jar
+- target/dependency/junit-3.8.jar
+- target/dependency/mimepull-1.3.jar
+- target/dependency/org.osgi.core-1.0.0.jar
+- target/dependency/resolver-20050927.jar
+- target/dependency/saaj-api-1.3.jar
+- target/dependency/saaj-impl-1.3.3.jar
+- target/dependency/slf4j-api-1.6.6.jar
+- target/dependency/stax-api-1.0-2.jar
+- target/dependency/stax-ex-1.2.jar
+- target/dependency/streambuffer-0.9.jar
+- target/dependency/wstx-asl-3.2.3.jar
+homepage: https://github.com/ricn/cmis
+licenses: []
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: !binary |-
+        MA==
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: !binary |-
+        MA==
+  none: false
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: A thin JRuby wrapper for the Apache Chemistry OpenCMIS client.
+test_files:
+- spec/cmis_spec.rb
+- spec/fixtures/document.pdf
+- spec/fixtures/text_file.txt
+- spec/fixtures/text_file2.txt
+- spec/spec_helper.rb