appletviewer(1) appletviewer(1)
NAME
appletviewer - Java applet viewer
SYNOPSIS
appletviewer [ -debug ] [ -encoding encodingname ]
[ -J javaoption ] urls ...
DESCRIPTION
The appletviewer command runs Java(tm) applets outside of the context
of a World Wide Web browser.
The appletviewer command connects to the document(s) or resource(s)
designated by urls and displays each applet referenced by that document
in its own window. Notice that if the documents referred to by urls do
not reference any applets with the OBJECT, EMBED, or APLET tag,
appletviewer does nothing.
appletviewer Tags
The appletviewer makes it possible to run a Java applet without using a
browser. appletviewer ignores any HTML that is not immediately rele-
vant to launching an applet. However, it recognizes a wide variety of
applet-launching syntax. The HTML code that appletviewer recognizes is
shown below. All other HTML code is ignored.
object The object tag is the HTML 4.0 tag for embedding applets and
multimedia objects into an HTML page. It is also an Internet
Explorer 4.x extension to HTML 3.2 which allows IE to run a
Java applet using the latest Java plugin from Sun.
<>
Please notice that:
]o appletviewer ignores the "classID" attribute, on the
assumption that it is pointing to the Java plugin, with the
value:
classid==""clsid::8AD9C8400-0044E-11D1-B3E9-00008005F499D93""
]o appletviewer also ignores the "codebase" attribute that is
usually included as part of the object tag, assuming that
it points to a Java plugin in a network cab file with a
value like:
codebase==""http:://java.sun.com/products/plugin/1.1/jinstall-11-win32.cab##Version==1,,1,,00,,00""
]o The optional codebase param tag supplies a relative URL
that specifies the location of the applet class.
]o Either code or object is specified, not both.
]o The type param tag is not used by appletviewer, but should
be present so that browsers load the plugin properly. For
an applet, the value should be something like:
<>
or
<>
For a serialized object or JavaBean, the type param value
should be something like:
<>
or
<>
]o Other param tags are argument values supplied to the
applet.
]o The object tag recognized by IE4.x and the embed tag recog-
nized by Netscape 4.x can be combined so that an applet can
use the latest Java plugin from Sun, regardless of the
browser that downloads the applet.
]o appletviewer does not recognize the javacode, javacode-
base, javaobject, or javatype param tags. These tags are
only needed when the applet defines parameters with the
names code, codebase, object, or type, respectively. (In
that situation, the plugin recognizes and uses the java
version in preference to the version that will be used by
the applet.) If the applet requires a parameter with one
of these four names, it may not run in appletviewer.
embed The embed tag is the Netscape extension to HTML 3.2 that
allows embedding an applet or a multimedia object in an HTML
page. It allows a Netscape 4.x browser (which supports HTML
3.2) to run a Java applet using the latest Java plugin from
Sun.
<>
Please notice that:
]o The object and embed tags can be combined so that an applet
can use the latest Java plugin from Sun, regardless of the
browser that downloads the applet. For more information,
see the Java PlugIn HTML Specification
]o Unlike the object tag, all values specified in an embed tag
are attributes (part of the tag) rather than parameters
(between the start tag and end tag, specified with a param
tag.
]o To supply argument values for applet parameters, you add
additional attributes to the embed tag.
]o appletviewer ignores the "src" attribute that is usually
part of an embed tag.
]o Either code or object is specified, not both.
]o The optional codebase attribute supplies a relative URL
that specifies the location of the applet class.
]o The type attribute is not used by appletviewer, but should
be present so that browsers load the plugin properly. For
an applet, the value should be something like:
<>...
or
<>...
For a serialized object or JavaBean, the type param value
should be something like:
<>...
or
<>...
]o The pluginspage attribute is not used by appletviewer, but
should be present so that browsers load the plugin prop-
erly. It should point to a Java plugin in a network cab
file with a value like:
pluginspage==""http:://java.sun.com/products/plugin/1.1/jinstall-11-win32.cab##Version==1,,1,,00,,00""
applet The applet tag is the original HTML 3.2 tag for embedding an
applet in an HTML page. Applets loaded using the applet tag
are run by the browser, which may not be using the latest
version of the Java platform. To ensure that the applet runs
with the latest version, use the object tag to load the Java
plugin into the browser. The plugin will then run the applet.
<>
Please notice that:
]o Either code or object is specified, not both.
]o The optional codebase attribute supplies a relative URL
that specifies the location of the applet class.
]o param tags supply argument values for applet parameters.
app The app tag was a short-lived abbreviation for applet that is
no longer supported. appletviewer translates the tag and
prints out an equivalent tag that is supported.
<>
<>
...
<>
OPTIONS
The following options are supported:
-debug Starts the applet viewer in the Java debugger, which debugs
applets in the document. (See jdb(1).)
-encoding encodingname
Specifies the input HTML file encoding name.
-J javaoption
Passes the string javaoption through as a single argument to
java(1) which runs the compiler. The argument should not
contain spaces. Multiple argument words must all begin with
the prefix -J, which is stripped. This is useful for adjust-
ing the execution environment or compiler memory usage.
EXAMPLES
The argument passed to appletviewer can be a file or an http url:
example%% appletviewer http:://java.sun.com/applets/jdk/1.2/demo/applets/ArcTest/example1.html
example%% appletviewer file::///Developer/Examples/Java/Applets/ArcTest/example1.html
SEE ALSO
java(1), jdb(1)
For more information, see
http:/java.sun.com/j2se/1.4/docs/guide/plugin/developerguide/index.html
or search java.sun.com for "Java Plug-In HTML Specification"
14 July 2000 appletviewer(1)
