You are viewing a plain text version of this content. The canonical link for it is here.
Posted to slide-dev@jakarta.apache.org by oz...@apache.org on 2004/10/22 11:23:28 UTC

cvs commit: jakarta-slide/proposals/wck README

ozeigermann    2004/10/22 02:23:28

  Modified:    proposals/wck README
  Log:
  Established link to WCK page on Slide website
  
  Revision  Changes    Path
  1.2       +1 -75     jakarta-slide/proposals/wck/README
  
  Index: README
  ===================================================================
  RCS file: /home/cvs/jakarta-slide/proposals/wck/README,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- README	12 Oct 2004 20:19:02 -0000	1.1
  +++ README	22 Oct 2004 09:23:28 -0000	1.2
  @@ -19,78 +19,4 @@
   use the native Slide interface. It will not work with ACL, BIND,
   SEARCH and DeltaV methods. 
   
  -The main interfaces
  --------------------
  -
  -To make Slide work as your WebDAV layer you will have to implement a
  -single interface: org.apache.slide.simple.store.BasicWebdavStore. It
  -contains some call back methods which do not use any Slide classes
  -except for the exceptions, which I thought are pretty obvious and thus
  -it would have been silly to more or less clone them. Here they are for
  -a short reference - for detailed documentation create the Javadocs of
  -the respective classes: 
  -
  -- begin, commit, rollback: begins, commits, aborts a request / transaction
  -- objectExists, isFolder, isResource: existence checks, collection
  -  vs. content checks 
  -- createFolder, createResource: creation of a collection or a content resource
  -- removeObject: deletion of a collection or a content resource
  -- setResourceContent, getResourceContent: storing and retrieval of a
  -  content resource 
  -- getLastModified, getCreationDate, getResourceLength: retrieval of
  -  basic meta data
  -- getChildrenNames: retrieval of the children of a collection
  -
  -This is all Slide and WCK need to make basic WebDAV operations
  -work. There are optional extension interfaces that add full property
  -access and locking if your system supports them. 
  -
  -The second main interface is even simpler and allows you to login into
  -Slide using your proprietary user database. The glue code will pass
  -session and connection information to your store as well. All this
  -allows to effectively bypass Slide's security code and leave this to
  -your system. All you have to implement are three methods of the
  -org.apache.slide.simple.authentication.SessionAuthenticationManager. 
  -
  -- getAuthenticationSession (2x one with user/password one with user
  -  only): asks if a certain user exists and authenticated itseld
  -  correctly and if so an object that allows access to your system,
  -  i.e. a session or connection or anything similiar, is passed back;
  -  in case the user has already authenticated correctly before only the
  -  user with no password is passed 
  -- closeAuthenticationSession: closes the session / terminates the
  -  connection to your system 
  -
  -Using this interface the glue code finds out if a user exists and
  -authenticated itself correctly and passes all relevant information to
  -the basic WebDAV store for you to make authenticated requests to your
  -system later. All this is optional, you still can use Slide's internal
  -security with your WebDAV store if this is not appropriate for
  -you. For your convenience there also is a connection pool
  -org.apache.slide.simple.authentication.AbstractPoolingConnectionManager
  -available. 
  -
  -Reference Implementation
  -------------------------
  -
  -For the store, the session manager and the pooling connection manager
  -there are reference implementations to the file system to help you get
  -going. However, the ones for sessions and connection management are
  -dummies only as the file system neither needs sessions nor
  -connections. You can find the code in the
  -org.apache.slide.simple.reference package. 
  -
  -The reference implementation of the store part and also
  -parts of the glue code are heavily inspired by the work of Alon who
  -provided the simple file store to us - so credit goes to Alon. The new
  -implementation of the file store extends Alon's in adding arbitrary
  -properties (optional) and locks (optional) and proper handling of
  -access violations. 
  -
  -Building
  ---------
  -
  -WCK works with both the current versions of Slide 2.1 and the CVS HEAD
  -and comes with a build script that creates a full working web archive
  -to be deployed in Tomcat. Which one it will compile to and package
  -with is to be determined in build.properties.
  \ No newline at end of file
  +More information on http://jakarta.apache.org/slide/wck.html
  \ No newline at end of file
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: slide-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: slide-dev-help@jakarta.apache.org