Novell WebDAV Command Beans

1.0 Introduction

The Novell WebDAV Command beans leverage the functionality of Web-based Distributed Authoring and Versioning protocol (WebDAV) as easy to use JavaBean components. WebDAV is a set of extensions to the HTTP, and supports collaborative work and content management on remote Web servers. It is based on an IETF Proposed Standard published as RFC 2518. For more information about WebDAV, visit the WebDAV Web site.

The set of beans are mainly targeted to application developers for creating custom applications and tools for content management. It supports all types of content, documents, images, and objects.

WebDAV Beans provide the following features:

• Reading the contents of resources managed by a WebDAV server
• Publishing web pages and documents to a WebDAV server
• Create, modify, read, and delete properties of resources managed by a WebDAV server
• Copy and move resources
• Locking mechanism to prevent data loss when multiple users access the same resource
• Create and delete a collection, add and remove members to/from the collection, and for listing the members of the collection

Novell provides the following WebDAV components:

• AuthenticateWebDAV
• CopyWebDAVResource
• CreateWebDAVCollection
• CreateWebDAVResource
• DeleteWebDAVResource
• ListWebDAVCollectionMembers
• LockWebDAVResource
• ModifyWebDAVProperties
• MoveWebDAVResource
• ReadWebDAVProperties
• ReadWebDAVResource
• UnauthenticateWebDAV
• UnlockWebDAVResource

The Novell Developer Web site provides information about the updates to the JavaBeans. Visit this site to download new beans and view updated versions of the documentation and component features.

2.0 What's New

• This is the first release of the WebDAV Command beans. They were previously available as Leading Edge component.
• Added support for char[] passwords.

3.0 Documentation

After you have installed the documentation, use the NDK Documents entry on your Start menu to quickly locate and access NDK documentation.

The documentation for the beans consists of html files and graphics files in several different directories.

To view the documentation, locate the index.html file in the install directory\doc directory and open that file in your Web browser.

4.0 Bean Dependencies

For all beans, the following are required:

• JVM 1.4 or above for NetWare or Windows*/Solaris/Linux. The JVM for NetWare can be downloaded from the NDK site.The JVM for the other platforms can be downloaded from the Sun Java site.
• WebDAV client libraries of Slide 1.0.16. This can be downloaded from the Jakarta site.

5.0 CLASSPATH Variable

Add the following libraries to the CLASSPATH:

• ecb.jar
• ecbwebdav.jar

Add the following WebDAV client libraries to the CLASSPATH:

• jaxp.jar
• crimson.jar
• webdavlib.jar
• commons-httpclient.jar

To get these files, download Slide from Jakarta Project Web site, and extract the above mentioned jar files.

6.0 Sample Programs

Sample programs are provided to demonstrate the usage of the beans in JSPs. They are bundled with the software package. By default, the SecretStore Command Beans samples are copied to c:\novell\ndk\samples\beans\bns_sscmd_sample directory.

6.1 Running the Sample Programs on a NetWare 6.0 Server

1. Copy the bns_webdavcmd_sample directory from the installed location to tomcat_home\webapps directory on the NetWare server.

   NOTE:  tomcat_home is the directory in which Apache Tomcat is installed.

2. Copy the jar files listed in the section CLASSPATH Variable to tomcat_home\webapps\bns_sscmd_sample\WEB-INF\lib directory.

3. Restart Tomcat server to save the settings.

4. To run the sample from the Web browser, use the following URL:

   http://server_name:8080/bns_webdavcmd_sample

6.2 Running the Sample Programs on a NetWare 6.5 Server

1. Copy the bns_sscmd_sample directory from the installed location to tomcat_home\webapps directory on the NetWare server.

   NOTE:  tomcat_home is the directory in which Apache Tomcat is installed.

2. Copy the jar files listed in the section CLASSPATH Variable to tomcat_home\webapps\bns_webdavcmd_sample\WEB-INF\lib directory.

3. Create a configuration file similar to beans-apache.conf provided under tomcat_home\conf directory and replace all occurrences of /ecb by /bns_sscmd_sample.

4. Add an Include statement for your new configuration file at the end of Apache conf file, httpd.conf found in apache_home\conf directory, e.g.Include sys:/tomcat/4/conf/beans-Apache.conf. This step makes Apache aware of this application.

   NOTE:  Apache_home is the directory where Apache is installed.

5. Restart Tomcat server to save the settings.

6. To run the sample from the Web browser, use the following URL:

   http://server_name:/bns_webdavcmd_sample

7.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

Copyright ^© 2003 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell is a registered trademark of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners.