Getting Started with JavaScript WebDAV Library
Download the library here and add <script> tag referencing ITHitWebDAVClient.js to your web page:
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>IT Hit WebDAV AJAX Library</title>
<script type="text/javascript" src="ITHitWebDAVClient.js" ></script>
</head>
<body>
...
</body>
</html>
The ITHitWebDAVClient.js is fully functional and does not have any limitations. However the trial period is limited to 1 month. After the trial period expires the API will stop working.
Logging
The library provides logging functionality that logs most of the information transferred between client and server such as WebDAV XML and HTTP headers. To setup logging call ITHit.Logger.AddListener method passing function reference that will receive logging messages:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>IT Hit WebDAV AJAX Library</title>
<script type="text/javascript" src="ITHitWebDAVClient.js" ></script>
<script type="text/javascript">
function logInfo(message)
{
document.getElementById("log").value += message;
}
ITHit.Logger.AddListener(logInfo, ITHit.LogLevel.Debug);
function run()
{
var session = new ITHit.WebDAV.Client.WebDavSession();
var item = session.OpenFolder("http://server:8080/");
}
</script>
</head>
<body onload="run()">
<textarea id="log" style="width: 600px; height: 400px" wrap=off></textarea>
</body>
</html>
The second parameter passed to AddListener method specifies the amount of information logged. During the development you will usually set log level to All or Debug, while deploying you can set it to Error or Fatal.
If any exception occurs it is being logged and if you experience any problems the first thing to do is to examine the log.
Authentication and SSL
The library supports SSL as well as any authentication supported by a browser. You will usually rely on a browser authentication mechanisms and do not need to care about authentication. The browser will pop the login dialog when required, requesting for credentials. The browser will keep the credentials and use it when necessary automatically.
Note that Internet Explorer on Windows Vista requires SSL connection when using Basic authentication. IE on Vista will not pop any dialog or warning if insecure connection is used with basic authentication. Details about how to overcome this limitation could be found here.
|