These pages offer a tree view of an URL structure. The root of the tree is defined by the "URL" field. It can be edited or used for selection. The entries in the tree view which are not containers are filtered by the pattern specified in the "Filter" field. The pattern is like a file pattern. It is case-sensitive.
The items in the tree view are all selectable. A selection can be manipulated by performing actions on them, which are to be picked from the popup menu. The inferior section of the menu is built-in. Its items are explained in the following table. The sections above are filled with user-defined actions, which are defined on the "Parameters" page.
| Copy | Copy the selected URLs and everything in them. The effect of the action is delayed until a paste action. If a copy is reissued before a paste only the last copy will produce an effect. |
| Cut | Remove the selected URLs and everything in them. The effect of the action is delayed until a paste action. If a cut is reissued before a paste only the last copy will produce an effect. |
| Delete | Immediately remove the selected URLs and everything in them. |
| Go Home | Change the root to the URL specified by the "user.home" system property. |
| Make Root | Create a new page with the root set to the selected URL. There may only be one selected URL and it must be a container. |
| New Container | Create a new container within the current container. |
| New Non-container | Create a new non-container within the current container. |
| Paste | Place the result of a copy or a cut operation in the selected URL. |
| Refresh | Reload the complete page. |
| Select All | Select all the URLs in the selected container. |
| Top | Collapse the complete page and open the root. |
The default action can be launched on an URL by double clicking on it or by selecting it and hitting the ENTER key (see also section "Default Action Patterns"). More than one URL may be selected.
All modifications done on this page are immediately saved in the
configuration file called
<user.home>/.be/re/app/uivi/Parameters, which is created
with sample parameters during start-up if it isn't present. All four tables on
the parameters page can be modified with the popup menu presented in the
following table.
| New | Create a new row in the table. |
| Delete | Remove the currently selected row from the table. |
| Up | Move the currently selected row one place higher. |
| Down | Move the currently selected row one place lower. |
| Set Default | Make the currently selected action the global default action. This is the action used if the selection on a page doesn't match a default action pattern. This menu item is only available for the "Actions" table. |
In this section actions can be defined, which are included in the
popup menu. The "Display Name" column contains the labels for the menu items.
The "Command Line" column describes a Java command line, i.e. a Java class name
followed by options. A useful class is be.re.util.Exec. Its
arguments together form a command line which is sent to the host system. This
way programs can be launched.
The display names define the structure of the popup menu. The order of the rows in the table defines the order of the menu items. A display name "separator" introduces a section line in the popup menu. A display name may be composed of parts separated by a forward slash ("/"). The parts become submenu items in the popup menu. Two menu items reside in the same submenu if they have exactly the same part structure.
A few symbols can be used in the definition of a command line. The "*" symbol is replaced by all the selected URLs on the navigator page for which the popup menu is activated. The "#" symbol is treated the same way, except that only URLs using the "file" protocol are retained. Everything between single or double quotes is placed in one argument position during command line construction.
In here file patterns can be associated with actions. When the default action is launched on an URL, its name is matched with the patterns in the user-specified order. The display name of the first matching row is used to retrieve the corresponding command line, which is then executed. Therefore the display name must be exactly the same as one in the "Actions" section. If no match is found the global default action is launched.
The default action pattern mechanism only works for a selection containing one URL. Otherwise the global default action is used.
The rows in this section are put in the "URL" field of every new navigator page. It is a pre-selection of URLs which are often used as the root of a page.
The filter patterns are file patterns which restrict the non-container URLs shown on a navigator page. The "Filter" field of a page is loaded with the rows in this section. It is a pre-selection of often used filter patterns.
The trash bin field must contain a valid writable URL. Otherwise it will be impossible to delete URLs on a navigator page. This is because in fact URLs are moved to the trash bin instead of being actually deleted. The same operation in the trash bin causes the URLs to be really deleted.
The task manager lists tasks which are running in the background. In that case the LED will be red. A task can be interrupted by selecting it and activating the popup menu item "Stop" on it or by typing "Ctrl+C".
Some URLs are only accessible through a proxy server. This can be
configured by creating the file
<user.home>/.be/re/net/ProxyManager. A default one is
created during start-up if none was found. The file must contain lines
with three fields separated by a ";" character. No spaces are allowed.
The first field specifies the host for which a proxy must be used. It can be a host name or an IP address. An IP address does not have to be complete, i.e. it may designate a network instead of a host by saying for example "192.168" or "192.168.1". If the first field has the value "default", a default proxy will be used for any host having no specific entry.
The second field defines the protocol to which the proxy definition applies. So a different proxy could be specified for "ftp" and "http". The protocol names must be the ones used for URLs.
The third field designates the proxy URL. Only "http" URLs are supported. If the value is "none" for a specific host or network, no proxy should be used.
If authentication is needed for some URL, a dialog box will popup
asking for a user name and a password. This information is kept in memory as
long as the application runs. So it will be asked only once. The dialog can be
avoided by creating the file
<user.home>/.be/re/net/BasicAuthenticator. A default one is
created during start-up if none was found. The file must contain lines with four
fields separated by a ";" character. No spaces are allowed. The file should be
unreachable for other users.
The first field indicates a resource name. It can be any string not containing ";". Usually it is host name or an URL, the proxy URL for example. The "default" value introduces a default user name and password for some protocol. The second field defines the protocol to which the entry applies. Currently "http", "ftp" and "pop3" are supported. The third and fourth fields are the user name and the password.
If more than one user is defined for a name, the first one will be used.
More advanced authentication is possible through the file
<user.home>/.be/re/net/URLAuthenticator. A default one is
created during start-up if none was found. The file must contain lines with
three fields separated by a ";" character. No spaces are allowed. The file
should be unreachable for other users.
The first field must contain an URL. The second and third field are the user name and the password. An authentication line is valid for the specified URL and all URLs which are logically under it, unless a separate line was defined for them. The user for for example ftp://ftp.a.com/pub/ is also valid for ftp://ftp.a.com/pub/doc/, unless the latter has a line of its own. The most specific line is always used.
While looking up authentication information, the file
URLAuthenticator is consulted first. If nothing could be found,
the file BasicAuthenticator is considered. Only then the dialog
box will popup.
These are welcome at uivi@re.be.
© 2000 Re BVBA. All rights granted except commercial ones.