AutoCAD WS APIs – JavaScript客户端[教程]

rumor

　　JavaScript客户端
* y, g: l+ n0 @2 ^' [- d' g
　　本教程旨在为您示范如何用WebdavClient Javascript类对您的AutoCAD WS账户中的文件和文件夹执行各种操作。使用这个JavaScript类，您可以——

, S. R4 [! U2 \) |! P6 r. k　　1.连接到一个AutoCAD WS账户上
* a- G) ?8 m, r! R; G
　　2.查询账户文件/文件夹结构

　　3.执行不同的文件操作，例如复制、粘贴、重命名、创建文件夹
$ X0 N: a- D, C# y) s) x
) j9 a( L% o; O0 Y　　4.上传和下载文件
8 b$ m- A7 F1 o& ]
　　5.查询文件元数据，例如最后修改、权限、缩略图
3 S* W" M( e/ K% e& \% D0 |- ~+ k
　　在WS在线编辑器中启动图纸文件

. c0 u( k2 m9 r& @' ]　　WebdavClient JS类依靠标准的WebDAV协议来和AutoCAD WS服务进行通信。C++、C#、Java和JavaScript等多种编程语言都支持这个基于http的行业协议。点击这里观看使用C#语言访问AutoCAD WS的教程。这个教程示范了如何在JavaScript中执行上述操作。我们还在下方嵌入了可供下载的客户端源代码。点击这里下载这个示范样例的完整源代码。

　　构造器

& E7 |. ]# _& ?1 L" `% j- T: |　　WeddavClient类构造器需要三个参数：

　　1. url：Webdav服务器地址。例如，如果您要连接到AutoCAD WS服务器，就用 “https://dav.autocadws.com”。

8 o& t+ v* O$ y" H4 E' T　　2. 用户名：您在Webdav服务器中的账户名
* O, U# B% t- m8 N+ _# [
　　3. 密码：您在Webdav服务器中的账户密码

　　下面的代码创建出新的WebdavClient类，连接到AutoCAD WS Webdav服务器，使用的用户名是“someuser”，密码是“123456”。
2 l$ H7 f4 X2 Q$ n* s3 {- w- J$ X+ c
8 A' o2 o* |4 z9 K; w( h! v$ W　　var client = new WebdavClient(’https://dav.autocadws.com’, ’someuser’, ’123456’);
: D; \7 I5 a% v/ N* C
1 F. V' ]  L! x　　PROPFIND
4 D, B9 I6 T3 P; T+ ]
　　PROPFIND方法用来在AutoCAD WS账户中检索关于文件和文件夹的信息。
8 `+ g6 m! G! y- Z
　　PROPFIND函数接收三个参数：

　　1. 处理器：一种可定义onError回调函数和onSuccessan回调函数的对象，这两种函数分别在请求过程中出错时和成功完成请求时调用。
$ H6 M: ?7 m  b% Z$ C) `4 X- ^3 `
1 B. h+ O, Q' ?$ M$ m. m　　2. 路径：我们想检索信息的文件夹/文件的相对路径。

" S2 Y4 E5 S9 n4 E　　3. 深度：表示该方法是仅适用于资源(深度=“0”)、仅适用于资源及其内部成员(深度=“1”)，还是适用于资源及其所有成员(深度=“无限”)。

1 j' w& D" I$ X0 v　　下列代码向服务器发送PROPFIND请求，以获取直接位于‘/Site’文件夹下的所有文件/文件夹的信息。

　　//A handler the implements onSuccess and onError functions

　　var handler = new PropfindHandler();

8 r/ T7 M# ?1 R1 s% y/ {, U# J- Y: w　　// request properties of all files/folders residing directly under the ’Site’ folder.

3 q+ |5 C7 \2 x$ F- H& r1 o　　client.PROPFIND(handler, ’/Site’, 1);

　　这个范例使用了PropfindHandle。我们稍后就展示该对象的代码。但是在这之前我们应该看看来自Webdav服务器的响应。服务器返回了一个含有文件/文件夹信息的XML。下面是这种XML的一个示例：

$ J6 j0 R' c. M5 q& [! Q/ p0 o　　
1 k& L) {3 P" A- ~
　　

; ?1 \6 \, |) T/ E+ L4 ]: t5 F　　

1 J) z& l& _* R  ]: u: W  I　　/Site/filea.dwg

　　
5 }- \5 w+ C4 h! @6 @" ^
8 o' ~; g4 ]- U+ g" @( C* E7 U　　HTTP/1.1 200 OK
/ p  S: N/ q( E3 k; @( x& ~0 m" v' g
% v0 Y1 Q+ s& c" r/ M0 `　　

; U8 `; h* O# g2 E$ H" H8 E9 `* q　　2011-12-01T17:42:21-08:00
" z8 M8 Z1 m1 M* [! P2 o
) o# I  d5 M& F* e　　filea.dwg
+ Q8 g0 i0 ~% s5 L
　　

　　

7 W) h% S) G7 ~　　

　　
' c# n5 z$ Q- e/ u0 r. p
　　/Site/fileb.dwg

. P% @1 O5 B# p' a　　

　　HTTP/1.1 200 OK
- @* v! g% t# s& s! i5 M
　　
6 n4 c5 X  H$ i
　　2011-12-01T17:42:21-08:00

9 r. f% S8 g' b1 e　　fileb.dwg

' ]* O7 T8 u' Y6 [' r2 V' T1 a　　
3 _3 y; S& b1 x; q( S4 _) v' I
0 W& n9 z# v0 L; a" j　　
* _0 q6 Y) t. @/ d& d
　　
, n# U1 `) |4 T3 ]7 C8 K
# q3 f4 P: {' e) M$ c( x　　
. Z4 }" d& I6 C
　　如您所见，每个文件/文件夹均返回到“d:response”标签中。在这种情况下，服务器返回“filea.dwg”和“fileb.dwg”这两个文件的信息。服务器注明了每个文件的创建日期和文件名。

　　您可能希望处理器的onSuccess函数能够解析已返回的XML，并对检索到的信息进行某些处理。

. ?7 l, t$ U; v3 k; o# j" t　　下面的代码展示的是非常简单的PropfindHandler，它显示了一个警告消息框，在出错的情况下这个消息框里含有状态代码，在成功的情况下则含有服务器返回的文件/文件夹名称：
2 }# n( ]# G+ Y" ~* J2 E$ ~) b- c2 V
　　function PropfindHandler()

5 X0 t6 h3 e5 E5 E" l# [: P1 n　　{

　　}

　　PropfindHandler.prototype.onSuccess = function(result)

8 ]& C. r2 @& O; E, J3 i　　{
" U2 x8 [* o8 ]9 a1 `
% d: _- t1 i; Z7 s" k7 l　　var names = ’’;
4 L  E  x  O) t" c9 r; x
　　// each file/folder is defined within a ’response’ tag
! k5 q) q$ u$ O( o  f
　　var items = this.getElementByTagName(result.content, ’d’, ’response’);

　　for (i = 0; i < items.length; i++)
* ?4 A. D6 T/ P% c
　　{

" {1 |, e% H6 [0 M  a　　var props = this.getElementByTagName(items, ’d’, ’prop’)[0];
& t" `5 s2 P/ D5 L* u& ?
　　var displayNameTag = this.getElementByTagName(props, ’d’, ’displayname’)[0];
5 u" H7 p5 _& l+ r& b) ?) G
2 r" g  @$ I! a; n% r　　var displayName = displayNameTag.childNodes[0].nodeValue;

　　names += displayName + ’/n’;
# q* U( I4 g- }, y$ ?0 F
* o5 A1 ~' @! r: ?　　}
% D; x) J4 D6 t6 Q& d# C: `; S
　　alert(names);

　　};

6 |2 _! k  i4 h: D% e( v4 o　　PropfindHandler.prototype.onError = function(result)
6 s2 P' l% t$ `8 `# A, R% b) S
; Y) c+ c" ^. o& |8 V　　{
& \6 o1 @( w- u' t+ @. ?
& }' w/ {8 z) H　　alert(result.status);
2 i1 K6 a5 @! k6 V( l+ o
　　}

　　如果以“someuser”为用户名的这个账户中包含文件夹“site”，而文件夹中有“filea.dwg”和“fileb.dwg”这两个文件，那么用户会看到一个消息框，其中显示了以下文件名：

　　filea.dwg
# u1 }' R. M6 d% K% m
　　fileb.dwg

　　复制、移动、删除

　　复制、移动和删除的调用方式和PROPFIND方法一样，只是传递的参数有所不同。
& T' c3 q" x9 I' W$ {& L
2 d+ N4 `) C4 x" N6 s% [$ C/ [2 n8 O　　它们都接收一个处理器对象，这一点与PROPFIND方法相似，但是在这种情况下没有需要解析的已返回信息。但是您应使用onSuccess和onError回调函数来了解请求是否已成功完成，并在出错时接收状态代码。
1 q' m5 x9 ^( Y0 u# o" [: I
　　下列代码：

/ q) v, T+ F4 S; q7 \7 Q* t　　1. copies ‘/Site/filea.dwg’ to /OtherSite/fileb.dwg’
- {6 x( C# K/ `
　　2. moves ‘/Site/filec.dwg’ to /OtherSite/filed.dwg’

+ p$ K5 A& W3 f6 [, q. q0 G　　3. deletes ‘/Site/filee.dwg’

　　var handler = new FSHandler();
  l7 [7 a2 I  a! i* @0 Y
( H3 U% h5 L- Q& a　　var overwrite = true;
2 L4 `! K! h+ r
　　client.COPY(handler, ’/Site/filea.dwg’, ’/OtherSite/fileb.dwg’, overwrite);
( F: y7 p6 S1 g: ~& {" r+ ?7 J
　　client.MOVE(handler, ’/Site/filec.dwg’, ’/OtherSite/filed.dwg’, overwrite);
  @( T: ^+ r9 s. X7 |
# x6 C7 ?" `& w5 A" R3 J, ?" m! }　　client.DELETE(handler, ’/Site/filee.dwg’);
9 q6 B* ^: k3 ]
　　下面的代码显示了FSHandler对象，这个对象显示的消息框在成功完成请求的情况下将显示“success”，在出错的情况下则显示“error”和状态代码。
5 }5 E& v5 _4 l. n9 H% ?* z, z
: W: a5 r, b6 c: m* a2 X9 d0 Q/ y　　function FSHandler()
$ \' K+ a; p. M; _
　　{

# c7 ]) K8 f1 W( M　　}

　　FSHandler.prototype.onSuccess = function(result)

　　{
' Q' O% ~+ Y( F$ V
　　alert(’success’);
7 H6 |$ [! ?8 h) m) h7 W/ p
　　};

　　FSHandler.prototype.onError = function(result)

: V$ O2 L- X% y' e; U" l- X7 c　　{

　　alert(’error: ’ + result.status);
' F  H$ q) C7 Q7 o; p5 t
7 z0 G* P2 U6 R/ L　　}
  X6 u) k- B" ?; \
# H, {" X" \; \9 F7 A　　同域策略和proxy.php
2 M( K. M0 Y" _4 L* [
　　同源策略可阻止从一个源加载的文档或脚本获取或设置来自另一个源的文档的属性。

　　这意味着我们不能将Webdav请求发送到与JS文件位于不同域的服务器上。

% \' ~# C# U' W1 w* r1 ~　　这是一个问题，因为Webdav服务器可能位于与客户端不同的域中。我们将会用php代理服务器绕过这个问题。

/ T5 h/ q+ B* t. K8 ~　　这个代理服务器应该与客户端位于同一个域。请求将被发送到代理服务器上，然后代理服务器把请求发送给Webdav服务器，再把应答返回到客户端。下面这行php文件信息定义了真正的Webdav服务器地址：
* @2 v) Z+ W0 Q
　　$real_destination_host = "https://dav.autocadws.com";
/ E4 E$ \. m; c: M; _! h- |0 j  [9 b
" z0 N/ i2 k  {6 S  p　　您必须确保您的服务器已完成了运行php文件所需的配置。

6 E9 q. G  L3 [　　点击这里获取指南，以了解如何安装和配置PHP 5，使之能够与Apache一起在Windows下运行。

　　在AutoCAD WS编辑器中启动图纸文件

: W" Y  W6 z1 S　　要在AutoCAD WS的在线编辑器中打开图纸文件，只需调用客户端OpenDrawing方法，以便用目标账户传递图纸文件的路径：

9 y9 b3 M. V; y  B9 L$ [( Q7 I6 V　　client.OpenDrawing(’/Site/filea.dwg’);
0 Q3 z: T' i: T
　　上传文件
4 K* W- g$ Y$ f4 J) V
2 k* s+ _9 ^+ \! @4 m　　您或许想实施一种方式，让用户可以在他的本地文件系统上选择一个文件，然后上传到Webdav服务器上。
2 p3 ]) S; R4 m/ ]
　　有些浏览器无法支持您访问用户的文件系统，所以有时候不一定能用javascript实施这项功能。
7 I, h. f" I0 \0 W
& m* H+ c2 F/ q　　在我们的样例中，我们用SWFUpload库来添加上传功能。

　　SWFUpload是一个小型的JavaScript/Flash库，它使您可以在您的html里轻松添加“上传”(Upload)按钮。Flash代码通过Flash的ExternalInterface类来与JS代码通信。如需了解关于SWFUpload的更多信息及示例，请访问SWFUpload网站

　　以上来自 欧特克AU技术社区http://au.autodesk.com.cn