User Installation Runing Winie Winie Uploading a document Downloading a document Deleting a document Preferences jwput, jwget, jwdel Configuration Examples

Programmer Winie API Jigsaw API

Installation:

Before reading further make sure That you have downloaded and installed any implementation of Java for your platform (JDK1.2).

1. Download the distribution.
2. Unzip it (eg: in <INSTDIR>)

Running Winie

• On Windows:
  • Use the script <INSTDIR>\Winie\bin\winie.bat
• On Unix:
  • Put the <INSTDIR>/Winie/bin directory in your PATH.
  • And you can use the scripts winie, jwget, jwput, jwdel located in <INSTDIR>/Winie/bin/.
• Manually, set your CLASSPATH
  • Unix: CLASSPATH=<INSTDIR>/Winie/classes/client.jar:<INSTDIR>/Winie/classes/winie.jar
  • Windows: CLASSPATH=<InstDir>\Winie\classes\client.jar;<InstDir>\Winie\classes\winie.jar
  and type java org.w3c.jwput.Winie

Winie

Uploading a document

To upload a document, just fill the "Source" field with the local document absolute path (this can be done by using the "Browse" button). Then fill the destination url in the "Destination" field and press the "Upload Document" button.

To upload the files located in a directory, just fill the "Source" field with the directory path. A dialog will ask you "do you want to perform this action recursively?". Answer yes, no or abort.

To upload several files, select them by using the "Browse" button (they will be filled in the "Source" field separated by some '|'). Note: The FileChooser multiple selection is not yet implemented in JDK1.2.2. If you want to configure or just take a look at the metadata sent to the destination server, before pressing the "Upload Document" button click on "Source Informations". You can specify the "Media Type", the "Content Encoding" and the "Charset".

Downloading a document

Winie allows you to download a document just by filling its url in the "Source" field. Fill the "Destination" field with the path where you want the file to be saved. Then press the "Download Document" button. You can specify some cache directive to be sure to get the latest version of the document. The HTTP Accept header can aslo be specified.

Deleting a document

Winie allows you to delete a document on a Web Server, just fill the "Document URL" field with its location and press "Delete Document".

Preferences

You can specify your preferences in the "Edit/Preferences" menu. Preferences are separated in four groups: Authentication, Connection, Languages and Proxy.

jwput, jwget, jwdel

JWPut

java org.w3c.jwput.JWPut [OPTION] [file] <url>

Options:

-delete	delete the remote file.
-h	display this message.
-header_XXX <value>	specify a HTTP header
-mime <mime-type>	Specify the mime type.
-overwrite	always overwrite remote files.
-no-proxy	direct connection.
-prompt	prompt monde on.
-user <username>	Auth: the user name.
-password <password>	Auth: the password.
-proxy-host <host>	eg: proxy.foobar.com
-proxy-port <port>	eg: 81 (default value)
-quiet	quiet mode on.
-r	recursive put.
-verbose	verbose mode on.

JWGet

java org.w3c.jwput.JWGet [OPTION] <url>

Options:

-h	display this message.
-header_XXX <value>	specify a HTTP header
-no-backup	disable backuping.
-no-proxy	direct connection.
-o <file>	specify the output file.
-prompt	prompt monde on.
-user <username>	Auth: the user name.
-password <password>	Auth: the password.
-proxy-host <host>	eg: proxy.foobar.com
-proxy-port <port>	eg: 81 (default value)
-quiet	quiet mode on.
-tries <number>	set number of retries (default is 3).
-verbose	verbose mode on.

Configuration:

You can edit the HOMEDIR/winie/preferences or use the GUI to change the default configuration:

#
# Winie User Preferences
#

# verbose mode
verbose = false

#quiet mode (no output at all)
quiet = false

#Do we use a http proxy?
proxySet  = false

# the proxy host
proxyHost = yourproxy.com

# the proxy port
proxyPort = 81

# authentication: username
#user      = foo

# authentication: password
#password  = bar

# prompt mode
prompt    = false

#
# MIME TYPES 
#

# default mime
#mimedef   = text/plain

#
# additional mime types
#
# format is:
#  file-extension = mime-type
#
# this is an example mpg is already defined
#
mpg        = video/mpeg

#
# for files without extension
#
noext      = text/plain
#
# Etags database configuration
# 
#etagsDB    = ETagManager

#
# Number of tries (when connection closed)
#
tries = 3

#
# Request headers
#

header_Accept-Language = en,fr
    

Examples:

jwput index.html http://www.foobar.com/html/index.html

jwput -r /home/toto/ http://www.foobar.com/html/

jwdel http://www.foobar.com/html/index.html

jwget http://www.foobar.com/index.html

jwget -header_Cache-control no-cache -header_Accept text/\* http://www.foobar.com/index.jpg

---

Mail comments to <bmahe@w3.org>
Last modified: Tue Oct 19 11:28:56 MET DST 1999