拾贝壳

走过的路
随笔 - 39, 文章 - 1, 评论 - 14, 引用 - 0
数据加载中……

Sliding into WebDAV

http://www.onjava.com/pub/a/onjava/2003/12/23/slide.html

翻译自:O'REILLY
sliding into webdav
by andrew anderson

apache下面的jakarta项目提供了许多伟大的开源项目。其中一个很有名的子项目就是slide,slide由很

多不同的模块组成,他们用webdav协议来连接。这些模块实现了大量有用的特性,比如webdav客户端库

,webdav服务段库,和一个基于webdav的cms.别的不说,首先这些模块将给开发者提供可以访问webdav

的客户端。
  这篇文章将介绍如何在java应用中用slide客户端库来访问 webdav服务。文章将首先介绍webdav的协

议,接着介绍slide项目,最后,我们将着手来写几个用slide客户端的例子。

WebDAV
WebDAV 代表了“Web-based Distributed Authoring and Versioning”。webdav是一套http协议的扩展

--允许用户来协作编辑和管理在远程服务器上的文件。因为这个协议扩展本身很简单而且很容易使用,

所以他的能量是很强大的。效果上,webdav使http 服务器增强为一个文件系统。大家知道类似ftp的协

议提供类似的协议很多年了,webdav's的特性比这些ftp协议更好,而且因此允许开发者使用webdav来创

建更强大的系统。

 因为不同的webdav服务器实现提供不同层次上的协议支持,下列的特性是最基本的而且可以使webdav区

别于ftp
 http-base:允许http的所有优点。(文件权限,快速转换,https支持,等等)
 put:可以上传资源到服务器
 lock:可以设置/取消 连接依赖,long-duration exclusive 和共享锁。
 Porperties:可以存储资源的任意元数据。
 Namespace manipulations:可以移动文件,拷贝文件,创建目录和列表目录。
这些特性允许开发所有不同类别的有趣应用,包括分布web-page authoring/editing 应用,版本控制应

用,邮件服务器,和分布式日历应用,还有很多。当开发者把webdav和“一次编写,到处运行”的java

联合时,编写多处理平台的分布客户端应用变得十分简单了。
WebDAV Tools and Resources
  和http一样,webdav需要服务段和客户端组件。除了slide项目之外--既提供了服务段又提供了客户端

,还有许多可用的 webdav 组件:
 1,apache的模块mod_dav(已经在apache2中包括了)
 2,microsoft的iis包含了webdav服务支持。
 3,mas os x允许mount一个webdav服务器作为一个网络磁盘。
   4,Apple's提供的iDisk.
更多的信息可以查看www.webdav.org
The Slide Project
 如前所述,slide项目的首页描述它为“a project composed of multiple modules tied together

using WebDAV”。这些多模块包括:
 1,一个CMS和她的Java API
 2,一个在cms之上用servlet实现的webdav协议。
 3,一个java版的webdav和http客户端库
 4,一个webdav命令行客户端
 5,一个访问webdav的swing组件(还没实现)
和其他的jakarta项目一样,slide提供了源文件和二进制文件。用户可以自己去下载。
如果已经下载并解压了他的安装文件,打开client/lib。这个目录包含了在本文例子中需要用到的jar文

件,包含了slide webdav的客户端库和许多额外包。doc/clientjavadoc下面有它的相关文档。
Using Slide
现在,我们来关注业务:应用SLIDE WEBDAV客户端库来连接webdav服务器。slide客户端封装了所有的功

能。我们需要通过WebdavResource 来访问WebDAV 服务器。访问一个WebDAV 服务器涉及到下面的3个基

本的步骤:
 1,打开一个到WebDAV服务器的连接
 2,发布协议请求并接受来自服务器的应答
 3,关闭连接。
打开WebDAV 服务器的连接可以通过WebdavResource的构造函数。有许多途径来处理;最直接的就是给构

造函数传递一个org.apache.util.HttpURL 对象--包含服务器的url和用户信息。
连接一旦建立,我们就可以发布我们的请求。这些协议请求被WebdavResource的很多函数处理。特别如


 1,aclfindMethod:用来查找access control lists;很多webdav服务器没有实现。
 2,aclMethod:用来设置acl,很多webdav服务器没有实现。
 3,copyMethod:复制一个资源从服务器上的一个位置到另一个位置
 4,deleteMethod 删除服务器上的一个资源。
 5,getMethod:获得一个服务器上的一个资源(和http的get方法一样)
 6,headMethod获得服务器资源的头文件(和http的head的命令一样)
 7,list:列出服务器当前目录下的资源
 8,lockMethod:锁定服务器上的一个资源
 9,mkcolMethod:在服务器上创建一个集合
 10,moveMethod:在服务器上移动资源
 11,optionsMethod:返回服务器支持的选项。(getDavCapabilities方法和

getAllowedMethods方法也提供这种功能)
  12,postMethod:获得服务器上的资源,通过http post(和http post命令一样)
 13,propFindMethod:返回一个资源的属性。
 14,propPatchMethod:设置或者获得一个资源的属性。
 15,putMethod:上传一个资源到服务器(类似ftp的put命令)
 16,setPath:设置服务期上的当前目录
 17,unlockMethod解锁服务器的资源
注意:有些slide的文档很弱。这片文章将会覆盖这里的部分方法,我们不会每个都涉及到。很多我们没

有涉及到的方法都没有好的文档。
WebdavResource 有很多其他的方法,提供了众多的功能;更多细节,请察看官方文档。
 一旦,你已经发布了协议请求,你需要关闭webdav的连接。这个用WebdavResource 的close()方法来做


A Simple Example
一个简单slide webdav例子,做了如下工作:
 打开连接,获得文件,关闭连接。
 当然,这个例子很简单,这个例子会用到java.net包。
代码如下:

//  Slide Simple WebDAV client example
import  java.io.File;
import  java.io.IOException;
import  java.net.MalformedURLException;

import  org.apache.commons.httpclient.HttpException;
import  org.apache.util.HttpURL;
import  org.apache.webdav.lib.WebdavResource;

public   class  SlideTest  {

    
public   static   void  main (String args[]) 
    
{
        
try
        
{
            HttpURL hrl 
=
                
new  HttpURL( " http://webdav-server " );
            hrl.setUserInfo(
" user " , " pass " );
            WebdavResource wdr 
=
                
new  WebdavResource(hrl);
            File fn 
=   new  File( " remote-file " );
            wdr.getMethod(fn);
            wdr.close();
        }

        
catch (MalformedURLException mue)
        
{
        }

        
catch (HttpException he)
        
{
        }

        
catch (IOException ioe)
        
{
        }
 
    }

}


你或许猜到了,真正的工作都在try-catch块中完成。最开始的2行建立了一个HttpURL 对象--饱含了连

接信息。然后我们通过HttpURL 创建了WebdavResource 。接着,我们创建了一个File对象来代表我们将

要下在的文件。 getMethod方法获得了这个文件,close方法关闭了连接。(注意,这里仅仅是一个例子

,你需要做更为谨慎的异常处理)

你看到了,我们用WebdavResource 很直接的处理不同端口的协议。把这个例子改造为上传文件很直接,

我们只需要改变少许几行,如下:
File fn = new File("local-file");
wdr.putMethod(fn);
 当然,这里还可以对文件重新命名。
这个例子很简单,但是演示了怎样来使用WebdavResource 来访问webdav服务器。在下一部分,我们将发

掘更多复杂的例子来演示如何用webdav来锁定和解锁文件。
More Complex Examples

可能有这样的场景,我们有一个web站点,这个站点被2个彼此分开的团队来维护。每个团队都有责任来

编辑html资源,但是站点管理员希望回避冲突。换句话说,我们都能上传,下在,锁定和解锁文件。我

们都想锁定文件来工作。
 来完成这一进程,我们需要如下的处理:
 1,打开连接。
 2,列出文件
 3,锁定文件
 4,下在文件
 5,上传文件
 6,解锁文件
 7,关闭连接
我们已经知道如何来打开连接,关闭连接,上传文件和下载文件。所以我们需要做的就是来处理锁定/解

锁文件和列出文件。我们假设已经有WebdavResource 对象和当前路径了。
首先,我们想要锁定文件。我们用lockMethod来实现,其他的代码用作错误处理。你将注意到我们设置

了WebdavResource的路径给文件--我们并没有非要用get和put方法。这是因为某些方法,包括

isCollection,getPath和setPath仅仅支持文件的当前目录。其他的方法,比如getMethod (不时

getMethodData 和getMethodDataAsString)并不支持这些接口。恩,有点乱。。
下面是锁定文件的代码:

public   boolean  lockFile(String filename)
    
throws  Exception
{
    
//  check to make sure current path is a
    
//  directory not a file make sure your initial
    
//  path contains a trailing "/" or else it is
    
//  considered a file!!

    
if  ( ! wdr.isCollection())
        
throw   new  Exception( " Path is currently a file " );

    String currentPath 
=  wdr.getPath();
    wdr.setPath(currentPath 
+   " / "   +  filename);
    
    
if  (wdr.isLocked())
    
{
        
return   false ;
    }

    
    
boolean  returnVal  =  wdr.lockMethod();
    wdr.setPath(currentPath);
    
return  returnVal;
}


方法unlockFile是一样的,我们同样是在WebdavResource对象上调用。
 列出当前目录下的文件,我们用listFiles方法来处理。注意在这个例子中,我们对是否是目录作了检

查。

public  String[] listFiles ()  throws  Exception
{
    
if ( ! wdr.isCollection())
        
throw   new  Exception ( " Path is currently a file " );
    
return  wdr.list();
}


 最终观点
Jakarta's Slide项目是连接webdav客户端功能和java应用的纽带。这个库是开源的,很容易使用,也很

容易集成到所有的系统中。尽管slide遗留了一些需要继续解决的问题,但是,他是实现webdav客户端最

成功的方案。

[译者按]:原文下面有很多精彩的q&a.也值得一看。

posted on 2007-01-03 20:49 binge 阅读(2413) 评论(0)  编辑  收藏 所属分类: J2EEOPEN SOURCE


只有注册用户登录后才能发表评论。


网站导航: