essentials of the java programming tm

language: a hands-on guide, part 1

by monica pawlan

if you are new to programming in the java language, have some

tm

experience with other languages, and are familiar with things like
displaying text or graphics or performing simple calculations, this
tutorial could be for you. it walks through how to use the java® 2
platform software to create and run three common types of programs
written for the java platform—applications, applets, and servlets.

you will learn how applications, applets, and servlets are similar and
different, how to build a basic user interface that handles simple end
user input, how to read data from and write data to files and
databases, and how to send and receive data over the network. this
tutorial is not comprehensive, but instead takes you on a straight and
uncomplicated path through the more common programming features
available in the java platform.

if you have no programming experience at all, you might still find this
tutorial useful; but you also might want to take an introductory
programming course or read teach yourself java 2 online in web time
before you proceed.

contents
lesson 1: compiling and running a simple program
• a word about the java platform

• setting up your computer

• writing a program

• compiling the program

• interpreting and running the program

• common compiler and interpreter problems

• code comments

• api documentation

• more information
lesson 2: building applications

• application structure and elements

• fields and methods

• constructors

• to summarize

• more information

lesson 3: building applets

• application to applet

• run the applet

• applet structure and elements

• packages

• more information

lesson 4: building a user interface

• swing apis

• import statements

• class declaration

• global variables

• constructor

• action listening

• event handling

• main method

• applets revisited

• more information

lesson 5: writing servlets

• about the example

• html form
 • servlet backend

• more information

lesson 6: file access and permissions

• file access by applications

• exception handling

• file access by applets

• granting applets permission

• restricting applications

• file access by servlets

• appending

• more information

lesson 7: database access and permissions

• database setup

• create database table

• database access by applications

o establishing a database connection

o final and private variables

o writing and reading data

• database access by applets

o jdbc driver

o jdbc-odbc bridge with odbc driver

• database access by servlets

• more information

lesson 8: remote method invocation

• about the example

o program behavior
 o file summary

o compile the example

o start the rmi registry

o run the remoteserver server object

o run the rmiclient1 program

o run the rmiclient2 program

• remotesend class

• send interface

• rmiclient1 class

• rmiclient2 class

• more information

in closing

lesson 1: compiling and running

a simple program

the computer age is here to stay. households and businesses all over
the world use computers in one way or another because computers
help individuals and businesses perform a wide range of tasks with
speed, accuracy, and efficiency. computers can perform all kinds of
tasks ranging from running an animated 3d graphics application with
background sound to calculating the number of vacation days you have
coming to handling the payroll for a fortune 500 company.

when you want a computer to perform tasks, you write a program. a

program is a sequence of instructions that define tasks for the
computer to execute. this lesson explains how to write, compile, and
run a simple program written in the java language (java program)
tm

that tells your computer to print a one-line string of text on the

console.

but before you can write and compile programs, you need to
understand what the java platform is, and set your computer up to run
the programs.

• a word about the java platform

 • setting up your computer

• writing a program

• compiling the program

• interpreting and running the program

• common compiler and interpreter problems

• code comments

• api documentation

• more information

a word about the java platform

the java platform consists of the java application programming
interfaces (apis) and the java1 virtual machine (jvm).

java apis are libraries of compiled code that you can use in your
programs. they let you add ready-made and customizable functionality
to save you programming time.
the simple program in this lesson uses a java api to print a line of text
to the console. the console printing capability is provided in the api
ready for you to use; you supply the text to be printed.
java programs are run (or interpreted) by another program called the
java vm. if you are familiar with visual basic or another interpreted
language, this concept is probably familiar to you. rather than running
directly on the native operating system, the program is interpreted by
the java vm for the native operating system. this means that any
computer system with the java vm installed can run java programs
regardless of the computer system on which the applications were
originally developed.
for example, a java program developed on a personal computer (pc)
with the windows nt operating system should run equally well without
modification on a sun ultra workstation with the solaris operating
system, and vice versa.
setting up your computer
before you can write and run the simple java program in this lesson,
you need to install the java platform on your computer system.
the java platform is available free of charge from the java.sun.com
web site. you can choose between the java® 2 platform software for
windows 95/98/nt or for solaris. the download page contains the
information you need to install and configure the java platform for
writing and running java programs.

note: make sure you have the java platform installed and
configured for your system before you try to write and run
the simple program presented next.

writing a program
the easiest way to write a simple program is with a text editor. so,
using the text editor of your choice, create a text file with the following
text, and be sure to name the text file exampleprogram.java. java
programs are case sensitive, so if you type the code in yourself, pay
particular attention to the capitalization.
//a very simple example

class exampleprogram {

public static void main(string[] args){

system.out.println("i'm a simple program");

}
here is the exampleprogram.java source code file if you do not want to
type the program text in yourself.
compiling the program
a program has to be converted to a form the java vm can understand
so any computer with a java vm can interpret and run the program.
compiling a java program means taking the programmer-readable text
in your program file (also called source code) and converting it to
bytecodes, which are platform-independent instructions for the java
vm.
the java compiler is invoked at the command line on unix and dos shell
operating systems as follows:

javac exampleprogram.java

note: part of the configuration process for setting up the

java platform is setting the class path. the class path can
be set using either the -classpath option with the javac

compiler command and java interpreter command, or by

setting the classpath environment variable. you need to

set the class path to point to the directory where the
exampleprogram class is so the compiler and interpreter
commands can find it. see java 2 sdk tools for more
information.

interpreting and running the program

once your program successfully compiles into java bytecodes, you can
interpret and run applications on any java vm, or interpret and run
applets in any web browser with a java vm built in such as netscape or
internet explorer. interpreting and running a java program means
invoking the java vm byte code interpreter, which converts the java
byte codes to platform-dependent machine codes so your computer
can understand and run the program.
the java interpreter is invoked at the command line on unix and dos
shell operating systems as follows:

java exampleprogram
at the command line, you should see:
i'm a simple program
here is how the entire sequence looks in a terminal window:

common compiler and interpreter problems

if you have trouble compiling or running the simple example in this
lesson, refer to the common compiler and interpreter problems lesson
in the java tutorial for troubleshooting help.
code comments
code comments are placed in source files to describe what is
happening in the code to someone who might be reading the file, to
comment-out lines of code to isolate the source of a problem for
debugging purposes, or to generate api documentation. to these ends,
the java language supports three kinds of comments: double slashes,
c-style, and doc comments.
double slashes

double slashes (//) are used in the c++ programming language, and
tell the compiler to treat everything from the slashes to the end of the
line as text.
//a very simple example

class exampleprogram {

public static void main(string[] args){

system.out.println("i'm a simple program");

}
c-style comments

instead of double slashes, you can use c-style comments (/* */) to
enclose one or more lines of code to be treated as text.
/* these are

c-style comments

*/

class exampleprogram {

public static void main(string[] args){

system.out.println("i'm a simple program");

}
doc comments
to generate documentation for your program, use the doc comments
(/** */) to enclose lines of text for the javadoc tool to find. the

javadoc tool locates the doc comments embedded in source files and
uses those comments to generate api documentation.
/** this class displays a text string at

* the console.

*/

class exampleprogram {

public static void main(string[] args){

system.out.println("i'm a simple program");

}
with one simple class, there is no reason to generate api
documentation. api documentation makes sense when you have an
application made up of a number of complex classes that need
documentation. the tool generates html files (web pages) that
describe the class structures and contain the text enclosed by doc
comments. the javadoc home page has more information on the
javadoc command and its output.
api documentation
the java platform installation includes api documentation, which
describes the apis available for you to use in your programs. the files
are stored in a doc directory beneath the directory where you installed
the platform. for example, if the platform is installed in
/usr/local/java/jdk1.2, the api documentation is in

/usr/local/java/jdk1.2/doc/api.
more information
see java 2 sdk tools for more information on setting the class path and
using the javac, and java commands.
see common compiler and interpreter problems lesson in the java
tutorial for troubleshooting help.

the javadoc home page has more information on the javadoc

command and its output.

you can also view the api documentation for the java 2 platform on the
java.sun.com site.

_______
1
as used on this web site, the terms "java virtual machine" or "jvm"
mean a virtual machine for the java platform.

lesson 2: building applications

all programs written in the java language (java programs) are built
tm

from classes. because all classes have the same structure and share
common elements, all java programs are very similar.

this lesson describes the structure and elements of a simple

application created from one class. the next lesson covers the same
material for applets.

• application structure and elements

• fields and methods

• constructors

• more information

application structure and elements

an application is created from classes. a class is similar to a record in

the pascal language or a struct in the c language in that it stores

related data in fields, where the fields can be different types. so you
could, for example, store a text string in one field, an integer in
another field, and a floating point in a third field. the difference
between a class and a record or struct is that a class also defines the
methods to work on the data.
for example, a very simple class might store a string of text and define
one method to set the string and another method to get the string and
print it to the console. methods that work on the data are called
accessor methods.

every application needs one class with a main method. this class is the

entry point for the program, and is the class name passed to the java
interpreter command to run the application.

the code in the main method executes first when the program starts,
and is the control point from which the controller class accessor
methods are called to work on the data.

here, again, is the example program from lesson 1. it has no fields or

accessor methods, but because it is the only class in the program, it
has a main method.

class exampleprogram {

public static void main(string[] args){

system.out.println("i'm a simple program");

the public static void keywords mean the java1 virtual machine
(jvm) interpreter can call the program's main method to start the
program (public) without creating an instance of the class (static), and
the program does not return data to the java vm interpreter (void)
when it ends.

an instance of a class is an executable copy of the class while the class

describes the data and behavior, you need a class instance to acquire
and work on data. the diagram at the left shows three instances of the
exampleprogram class by the names: firstinstance,

secondinstance and thirdinstance.

the main method is static to give the java vm interpreter a way to start
the class without creating an instance of the control class first.
instances of the control class are created in the main method after the
program starts.
the main method for the simple example does not create an instance

of the exampleprogram class because none is needed. the

exampleprogram class has no other methods or fields, so no class

instance is needed to access them from the main method. the java
platform lets you execute a class without creating an instance of that
class as long as its static methods do not call any non-static methods
or fields.
the exampleprogram class just calls println, which is a static method

in the system class. the java.lang.system class, among other things,

provides functionality to send text to the terminal window where the
program was started. it has all static fields and methods.
the static fields and methods of a class can be called by another
program without creating an instance of the class. so, just as the java
vm interpreter command could call the static main method in the
exampleprogram class without creating an instance of the

exampleprogram class, the exampleprogram class can call the static

println method in the system class, without creating an instance of

the system class.

however, a program must create an instance of a class to access its
non-static fields and methods. accessing static and non-static fields
and methods is discussed further with several examples in the next
section.
fields and methods
the lessontwoa.java program alters the simple example to store the
text string in a static field called text. the text field is static so its
data can be accessed directly without creating an instance of the
lessontwoa class.

class lessontwoa {

static string text = "i'm a simple program";

public static void main(string[] args){

system.out.println(text);

the lessontwob.java and lessontwoc.java programs add a gettext

method to the program to retrieve and print the text.

the lessontwob.java program accesses the non-static text field with

the non-static gettext method. non-static methods and fields are

called instance methods and fields. this approach requires that an
instance of the lessontwob class be created in the main method. to
keep things interesting, this example includes a static text field and a
non-static instance method (getstatictext) to retrieve it.

note: the field and method return values are all type
 string.

class lessontwob {

string text = "i'm a simple program";

static string text2 = "i'm static text";

string gettext(){

return text;

string getstatictext(){

return text2;

public static void main(string[] args){

lessontwob proginstance = new lessontwob();

string retrievedtext = proginstance.gettext();

string retrievedstatictext =

proginstance.getstatictext();

system.out.println(retrievedtext);

system.out.println(retrievedstatictext);

the lessontwoc.java program accesses the static text field with the

static gettext method. static methods and fields are called class
methods and fields. this approach allows the program to call the static
gettext method directly without creating an instance of the

lessontwoc class.

class lessontwoc {

static string text = "i'm a simple program";

//accessor method

static string gettext(){

return text;

public static void main(string[] args){

string retrievedtext = gettext();

system.out.println(retrievedtext);

}
so, class methods can operate only on class fields, and instance
methods can operate on class and instance fields.
you might wonder what the difference means. in short, there is only
one copy of the data stored or set in a class field but each instance has
its own copy of the data stored or set in an instance field.

the figure above shows three class instances with one static field and
one instance field. at runtime, there is one copy of the value for static
field a and each instance points to the one copy. when setfielda(50) is
called on the first instance, the value of the one copy changes from 36
to 50 and all three instances point to the new value. but, when
setfieldb(25) is called on the first instance, the value for field b
changes from 0 to 25 for the first instance only because each instance
has its own copy of field b.
see understanding instance and class members lesson in the java
tutorial for a thorough discussion of this topic.
constructors
classes have a special method called a constructor that is called when
a class instance is created. the class constructor always has the same
name as the class and no return type. the lessontwod program
converts the lessontwob program to use a constructor to initialize the
text string.

note: if you do not write your own constructor, the

compiler adds an empty constructor, which calls the no-
arguments constructor of its parent class. the empty
constructor is called the default constructor. the default
constructor initializes all non-initialized fields and variables
to zero.

class lessontwod {

string text;

//constructor

lessontwod(){

text = "i'm a simple program";

//accessor method

string gettext(){

return text;
 }

public static void main(string[] args){

lessontwod proginst = new lessontwod();

string retrievedtext = proginst.gettext();

system.out.println(retrievedtext);

to summarize
a simple program that prints a short text string to the console would
probably do everything in the main method and do away with the

constructor, text field, and gettext method. but, this lesson used a
very simple program to show you the structure and elements in a basic
java program.
more information
see understanding instance and class members lesson in the java
tutorial for a thorough discussion of this topic.
_______
1
as used on this web site, the terms "java virtual machine" or "jvm"
mean a virtual machine for the java platform.

lesson 3: building applets

[<<back] [contents] [next>>]
like applications, applets are created from classes. however, applets do
not have a main method as an entry point, but instead, have several
methods to control specific aspects of applet execution.

this lesson converts an application from lesson 2 to an applet and

describes the structure and elements of an applet.

• application to applet

• run the applet

 • applet structure and elements

• packages

• more information

application to applet

the following code is the applet equivalent to the lessontwob

application from lesson 2. the figure below shows how the running
applet looks. the structure and elements of the applet code are
discussed after the section on how to run the applet just below.

import java.applet.applet;

import java.awt.graphics;

import java.awt.color;

public class simpleapplet extends applet{

string text = "i'm a simple applet";

public void init() {

text = "i'm a simple applet";

setbackground(color.cyan);

public void start() {

system.out.println("starting...");
 }

public void stop() {

system.out.println("stopping...");

public void destroy() {

system.out.println("preparing to unload...");

public void paint(graphics g){

system.out.println("paint");

g.setcolor(color.blue);

g.drawrect(0, 0,

getsize().width -1,

getsize().height -1);

g.setcolor(color.red);

g.drawstring(text, 15, 25);

the simpleapplet class is declared public so the program that runs

the applet (a browser or appletviewer), which is not local to the

program can access it.
run the applet

to see the applet in action, you need an html file with the applet tag
as follows:

<html>

<body>

<applet code=simpleapplet.class width=200 height=100>

</applet>

</body>
</html>

the easiest way to run the applet is with appletviewer shown below
where simpleapplet.html is a file that contains the above html code:

appletviewer simpleapplet.html

note: to run an applet written with java 2 apis in a

tm

browser, the browser must be enabled for the java 2

platform. if your browser is not enabled for the java 2
platform, you have to use appletviewer to run the applet or
install java plug-in. java plug-in lets you run applets on
web pages under the 1.2 version of the java vm instead of
the web browser's default java vm.

applet structure and elements

the java api applet class provides what you need to design the
appearance and manage the behavior of an applet. this class provides
a graphical user interface (gui) component called a panel and a
number of methods. to create an applet, you extend (or subclass) the
applet class and implement the appearance and behavior you want.

the applet's appearance is created by drawing onto the panel or by

attaching other gui components such as push buttons, scrollbars, or
text areas to the panel. the applet's behavior is defined by
implementing the methods.

extending a class
most classes of any complexity extend other classes. to extend
another class means to write a new class that can use the fields and
methods defined in the class being extended. the class being extended
is the parent class, and the class doing the extending is the child class.
another way to say this is the child class inherits the fields and
methods of its parent or chain of parents. child classes either call or
override inherited methods. this is called single inheritance.

the simpleapplet class extends applet class, which extends the

panel class, which extends the container class. the container class

extends object, which is the parent of all java api classes.

the applet class provides the init, start, stop, destroy, and paint

methods you saw in the example applet. the simpleapplet class

overrides these methods to do what the simpleapplet class needs

them to do. the applet class provides no functionality for these

methods.

however, the applet class does provide functionality for the

setbackground method,which is called in the init method. the call to

setbackground is an example of calling a method inherited from a

parent class in contrast to overriding a method inherited from a parent
class.

you might wonder why the java language provides methods without
implementations. it is to provide conventions for everyone to use for
consistency across java apis. if everyone wrote their own method to
start an applet, for example, but gave it a different name such as
begin or go, the applet code would not be interoperable with other
programs and browsers, or portable across multiple platforms. for
example, netscape and internet explorer know how to look for the
init and start methods.

behavior
an applet is controlled by the software that runs it. usually, the
underlying software is a browser, but it can also be appletviewer as
you saw in the example. the underlying software controls the applet by
calling the methods the applet inherits from the applet class.

the init method: the init method is called when the applet is first
created and loaded by the underlying software. this method performs
one-time operations the applet needs for its operation such as creating
the user interface or setting the font. in the example, the init method
initializes the text string and sets the background color.

the start method: the start method is called when the applet is
visited such as when the end user goes to a web page with an applet
on it. the example prints a string to the console to tell you the applet
is starting. in a more complex applet, the start method would do
things required at the start of the applet such as begin animation or
play sounds.

after the start method executes, the event thread calls the paint

method to draw to the applet's panel. a thread is a single sequential

flow of control within the applet, and every applet can run in multiple
threads. applet drawing methods are always called from a dedicated
drawing and event-handling thread.

the stop and destroy methods: the stop method stops the applet
when the applet is no longer on the screen such as when the end user
goes to another web page. the example prints a string to the console
to tell you the applet is stopping. in a more complex applet, this
method should do things like stop animation or sounds.
the destroy method is called when the browser exits. your applet
should implement this method to do final cleanup such as stop live
threads.

appearance

the panel provided in the applet class inherits a paint method from

its parent container class. to draw something onto the applet's

panel, you implement the paint method to do the drawing.

the graphics object passed to the paint method defines a graphics

context for drawing on the panel. the graphics object has methods
for graphical operations such as setting drawing colors, and drawing
graphics, images, and text.

the paint method for the simpleapplet draws the i'm a simple applet
string in red inside a blue rectangle.

public void paint(graphics g){

system.out.println("paint");

//set drawing color to blue

g.setcolor(color.blue);

//specify the x, y, width and height for a rectangle

g.drawrect(0, 0,

getsize().width -1,

getsize().height -1);

//set drawing color to red

g.setcolor(color.red);

//draw the text string at the (15, 25) x-y location

g.drawstring(text, 15, 25);

packages

the applet code also has three import statements at the top.
applications of any size and all applets use import statements to
access ready-made java api classes in packages. this is true whether
the java api classes come in the java platform download, from a third-
party, or are classes you write yourself and store in a directory
separate from the program. at compile time, a program uses import
statements to locate and reference compiled java api classes stored in
packages elsewhere on the local or networked system. a compiled
class in one package can have the same name as a compiled class in
another package. the package name differentiates the two classes.
the examples in lessons 1 and 2 did not need a package declaration to
call the system.out.println java api class because the system class

is in the java.lang package that is included by default. you never

need an import java.lang.* statement to use the compiled classes

in that package.

more information
you can find more information on applets in the writing applets trail in
the java tutorial.

lesson 4: building a user interface

[<<back] [contents] [next>>]

in the last lesson you saw how the applet class provides a panel
component so you can design the applet's user interface. this lesson
expands the basic application from lessons 1 and 2 to give it a user
interface using the java foundation classes (jfc) project swing apis
tm

that handle user events.

• project swing apis

• import statements

• class declaration

• instance variables

• constructor

• action listening

• event handling
 • main method

• applets revisited

• more information

project swing apis

in contrast to the applet in lesson 3 where the user interface is

attached to a panel object nested in a top-level browser, the project
swing application in this lesson attaches its user interface to a panel
object nested in a top-level frame object. a frame object is a top-level
window that provides a title, banner, and methods to manage the
appearance and behavior of the window.
the project swing code that follows builds this simple application. the
window on the left appears when you start the application, and the
window on the right appears when you click the button. click again and
you are back to the original window on the left.

when application starts when button clicked

import statements
here is the swingui.java code. at the top, you have four lines of import
statements. the lines indicate exactly which java api classes the
tm

program uses. you could replace four of these lines with this one line:
import java.awt.*;, to import the entire awt package, but doing that
increases compilation overhead than importing exactly the classes you
need and no others.
import java.awt.color;

import java.awt.borderlayout;

import java.awt.event.*;
import javax.swing.*;

class declaration
the class declaration comes next and indicates the top-level frame for
the application's user interface is a jframe that implements the

actionlistener interface.
class swingui extends jframe

implements actionlistener{

the jframe class extends the frame class that is part of the abstract
window toolkit (awt) apis. project swing extends the awt with a full set
of gui components and services, pluggable look and feel capabilities,
and assistive technology support. for a more detailed introduction to
project swing, see the swing connection, and fundamentals of swing,
part 1.

the java apis provide classes and interfaces for you to use. an interface
defines a set of methods, but does not implement them. the rest of
the swingui class declaration indicates that this class will implement

the actionlistener interface. this means the swingui class must

implement all methods defined in the actionlistener interface.

fortunately, there is only one, actionperformed, which is discussed

below.

instance variables
these next lines declare the project swing component classes the
swingui class uses. these are instance variables that can be accessed
by any method in the instantiated class. in this example, they are built
in the swingui constructor and accessed in the actionperformed

method implementation. the private boolean instance variable is

visible only to the swingui class and is used in the

actionperformedmethod to find out whether or not the button has

been clicked.
jlabel text, clicked;
 jbutton button, clickbutton;

jpanel panel;

private boolean _clickmemode = true;

constructor
the constructor (shown below) creates the user interface components
and jpanel object, adds the components to the jpanel object, adds

the panel to the frame, and makes the jbutton components event

listeners. the jframe object is created in the main method when the
program starts.
swingui(){

text = new jlabel("i'm a simple program");

clicked = new jlabel("button clicked");

button = new jbutton("click me");

//add button as an event listener

button.addactionlistener(this);

clickbutton = new jbutton("click again");

//add button as an event listener

clickbutton.addactionlistener(this);

//create panel

panel = new jpanel();

//specify layout manager and background color

panel.setlayout(new borderlayout(1,1));

panel.setbackground(color.white);

//add label and button to panel

getcontentpane().add(panel);

panel.add(borderlayout.center, text);
 panel.add(borderlayout.south,

button);

when the jpanel object is created, the

layout manager and background color are specified. the layout
manager in use determines how user interface components are
arranged on the display area.

the code uses the borderlayout layout manager, which arranges user
interface components in the five areas shown at left. to add a
component, specify the area (north, south, east, west, or center).

//create panel

panel = new jpanel();

//specify layout manager and background color

panel.setlayout(new borderlayout(1,1));

panel.setbackground(color.white);

//add label and button to panel

getcontentpane().add(panel);

panel.add(borderlayout.center, text);

panel.add(borderlayout.south, button);

}
to find out about some of the other available layout managers and how
to use them, see the jdc article exploring the awt layout managers.

the call to the getcontentpane method of the jframe class is for

adding the panel to the jframe. components are not added directly to

a jframe, but to its content pane. because the layout manager

controls the layout of components, it is set on the content pane where
the components reside. a content pane provides functionality that
allows different types of components to work together in project
swing.
action listening

in addition to implementing the actionlistener interface, you have to

add the event listener to the jbutton components. an action listener is
the swingui object because it implements the actionlistener interface.
in this example, when the end user clicks the button, the underlying
java platform services pass the action (or event) to the
actionperformed method. in your code, you implement the
actionperformed method to take the appropriate action based on which
button is clicked..
the component classes have the appropriate add methods to add
action listeners to them. in the code the jbutton class has an
addactionlistener method. the parameter passed to addactionlistener is
this, which means the swingui action listener is added to the button so
button-generated actions are passed to the actionperformed method in
the swingui object.

button = new jbutton("click me");

//add button as an event listener

button.addactionlistener(this);

event handling
the actionperformed method is passed an event object that represents
the action event that occurred. next, it uses an if statement to find out
which component had the event, and takes action according to its
findings.
public void actionperformed(actionevent event){

object source = event.getsource();

if (_clickmemode) {

text.settext("button clicked");

button.settext("click again");

_clickmemode = false;

} else {

text.settext("i'm a simple program");

button.settext("click me");

_clickmemode = true;

}
 }
you can find information on event handling for the different
components in the java tutorial section on event handling.
main method

the main method creates the top-level frame, sets the title, and
includes code that lets the end user close the window using the frame
menu.
public static void main(string[] args){

//create top-level frame

swingui frame = new swingui();

frame.settitle("example");

//this code lets you close the window

windowlistener l = new windowadapter() {

public void windowclosing(windowevent e) {

system.exit(0);

};

frame.addwindowlistener(l);

//this code lets you see the frame

frame.pack();

frame.setvisible(true);

}
the code for closing the window shows an easy way to add event
handling functionality to a program. if the event listener interface you
need provides more functionality than the program actually uses, use
an adapter class. the java apis provide adapter classes for all listener
interfaces with more than one method. this way, you can use the
adapter class instead of the listener interface and implement only the
methods you need. in the example, the windowlistener interface has 7
methods and this program needs only the windowclosing method so it
makes sense to use the windowadapter class instead.
this code extends the windowadapter class and overrides the
windowclosing method. the new keyword creates an anonymous
instance of the extended inner class. it is anonymous because you are
not assigning a name to the class and you cannot create another
instance of the class without executing the code again. it is an inner
class because the extended class definition is nested within the swingui
class.

this approach takes only a few lines of code, while implementing the
windowlistener interface would require 6 empty method
implementations. be sure to add the windowadapter object to the
frame object so the frame object will listen for window events.

windowlistener l = new windowadapter() {

//the instantiation of object l is extended to

//include this code:

public void windowclosing(windowevent e){

system.exit(0);

};

frame.addwindowlistener(l);

applets revisited
using what you learned in lesson 3: building applets and this lesson,
convert the example for this lesson into an applet. give it a try before
looking at the solution.

in short, the differences between the applet and application versions

are the following:

• the applet class is declared public so appletviewer can access

it.
 • the applet class descends from applet and the application class

descends from jframe.

• the applet version has no main method.

• the application constructor is replaced in the applet by start

and init methods.

• gui components are added directly to the applet; whereas, in

the case of an application, gui components are added to the
content pane of its jframe object.

more information
for more information on project swing, see the swing connection, and
fundamentals of swing, part 1.
also see the jfc project swing tutorial: a guide to constructing guis.

to find out about some of the other available layout managers and how
to use them, see the jdc article exploring the awt layout managers.

lesson 5: writing servlets

[<<back] [contents] [next>>]
a servlet is an extension to a server that enhances the server's
functionality. the most common use for a servlet is to extend a web
server by providing dynamic web content. web servers display
documents written in hypertext markup language (html) and respond
to user requests using the hypertext transfer protocol (http). http is
the protocol for moving hypertext files across the internet. html
documents contain text that has been marked up for interpretation by
an html browser such as netscape.

servlets are easy to write. all you need is the java® 2 platform
software, and javaserver web development kit (jwsdk). you can
tm

download a free copy of the jwsdk.

this lesson shows you how to create a very simple form that invokes a
basic servlet to process end user data entered on the form.

• about the example

 • html form

• servlet backend

• more information

about the example

a browser accepts end user input through an html form. the simple
form used in this lesson has one text input field for the end user to
enter text and a submit button. when the end user clicks the submit
button, the simple servlet is invoked to process the end user input.
in this example, the simple servlet returns an html page that displays
the text entered by the end user.

html form
the html form is embedded in this html file. the diagram shows how
the html page looks when it is opened in a browser.
the html file and form are similar to
the simple application and applet
examples in lesson 4 so you can
compare the code and learn how
servlets, applets, and applications
handle end user inputs.

when the user clicks the click me

button, the servlet gets the entered
text, and returns an html page with
the text.

the html page returned to the browser by the exampservlet.java

servlet is shown below. the servlet code to retrieve the user's input
and generate the html page follows with a discussion.
 note: to run the example, you have to put the servlet and
html files in the correct directories for the web server you
are using. for example, with java webserver 1.1.1, you
place the servlet in the ~/javawebserver1.1.1/servlets

and the html file in the

~/javawebserver1.1.1/public_html directory.

servlet backend
exampservlet.java builds an html page to return to the end user. this
means the servlet code does not use any project swing or abstract
window toolkit (awt) components or have event handling code. for this
simple servlet, you only need to import these packages:

• java.io for system input and output. the httpservlet class

uses the ioexception class in this package to signal that an

input or output exception of some kind has occurred.

• javax.servlet, which contains generic (protocol-independent)

servlet classes. the httpservlet class uses the

servletexception class in this package to indicate a servlet

problem.

• javax.servlet.http, which contains http servlet classes. the

httpservlet class is in this package.

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;
public class exampservlet extends httpservlet {

public void dopost(httpservletrequest request,

httpservletresponse response)

throws servletexception, ioexception

response.setcontenttype("text/html");

printwriter out = response.getwriter();

out.println("<title>example</title>" +

"<body bgcolor=ffffff>");

out.println("<h2>button clicked</h2>");

string data = request.getparameter("data");

if(data != null){

out.println(data);

} else {

out.println("no text entered.");

out.println("<p>return to

<a href="../simplehtml.html">form</a>");

out.close();

class and method declarations

all servlet classes extend the httpservlet abstract class.

httpservlet simplifies writing http servlets by providing a framework

for handling the http protocol. because httpservlet is abstract, your

servlet class must extend it and override at least one of its methods.
an abstract class is a class that contains unimplemented methods
and cannot be instantiated itself.
public class exampservlet extends httpservlet {

public void dopost(httpservletrequest request,

httpservletresponse response)

throws servletexception, ioexception

the exampservlet class is declared public so the web server that runs
the servlet, which is not local to the servlet, can access it.

the exampservlet class defines a dopost method with the same name,

return type, and parameter list as the dopost method in the

httpservlet class. by doing this, the exampservlet class overrides

and implements the dopost method in the httpservlet class.

the dopost method performs the http post operation, which is the
type of operation specified in the html form used for this example. the
other possibility is the http get operation, in which case you would

implement the doget method instead.

in short, post requests are for sending any amount of data directly

over the connection without changing the url, and get requests are for

getting limited amounts of information appended to the url. post

requests cannot be bookmarked or emailed and do not change the
uniform resource locators (url) of the response. get requests can be
bookmarked and emailed and add information to the url of the
response.
the parameter list for the dopost method takes a request and a

response object. the browser sends a request to the servlet and the
servlet sends a response back to the browser.

the dopost method implementation accesses information in the

request object to find out who made the request, what form the
request data is in, and which http headers were sent, and uses the
response object to create an html page in response to the browser's

request. the dopost method throws an ioexception if there is an

input or output problem when it handles the request, and a
servletexception if the request could not be handled. these

exceptions are handled in the httpservlet class.

method implementation

the first part of the dopost method uses the response object to create

an html page. it first sets the response content type to be text/html,

then gets a printwriter object for formatted text output.

response.setcontenttype("text/html");

printwriter out = response.getwriter();

out.println("<title>example</title>" +

"<body bgcolor=#ffffff>");

out.println("<h2>button clicked</h2>");

the next line uses the request object to get the data from the text

field on the form and store it in the data variable. the getparameter

method gets the named parameter, returns null if the parameter was
not set, and an empty string if the parameter was sent without a
value.
string data = request.getparameter("data");
the next part of the dopost method gets the data out of the data

parameter and passes it to the response object to add to the html

response page.
if(data != null){

out.println(data);

} else {

out.println("no text entered.");

the last part of the dopost method creates a link to take the end user
from the html response page back to the original form, and closes the
response.
out.println("<p>return to

<a href="../simplehtml.html">form</a>");

out.close();

note: to learn how to use the other methods available in

the httpservlet, httpservletrequest, and

httpservletresponse classes, see the java tutorial trail

on servlets.

more information
you can find more information on servlets in the servlets trail in the
java tutorial.

lesson 6: file access and permissions

[<<back] [contents] [next>>]
so far, you have learned how to retrieve and handle a short text string
entered from the keyboard into a simple graphical user interface (gui).
but programs also retrieve, handle, and store data in files and
databases.
this lesson expands the examples from previous lessons to perform
basic file access using the application programming interfaces (apis) in
the java.io package. it also shows you how to grant applets
permission to access specific files, and how to restrict an application so
it has access to specific files only.

• file access by applications

• system properties

• file.separatorchar

• exception handling

• file access by applets

• granting applets permission

• restricting applications

• file access by servlets

• appending

• more informattion

file access by applications

the java® 2 platform software provides a rich range of classes for
reading character or byte data into a program, and writing character or
byte data out to an external file, storage device, or program. the
source or destination might be on the local computer system where
the program is running or anywhere on the network.
this section shows you how to read data from and write data to a file
on the local computer system. see trail on reading and writing
the javatm tutorial

for information on transferring data between programs, between a

program and memory, and performing operations such as buffering or
character encoding on data as it is read or written.

• reading: a program opens an input stream on the file and reads

the data in serially (in the order it was written to the file).

• writing: a program opens an output stream on the file and

writes the data out serially.
this first example converts the swingui.java example from lesson 4 to
accept user input through a text field. the window on the left appears
when you start the fileio application, and the window on the right
appears when you click the button. when you click the button,
whatever is entered into the text field is saved to a file. after that,
another file is opened and read and its text is displayed in the window
on the right. click again and you are back to the original window with a
blank text field ready for more input.

constructor

actionperformed

constructor and instance variable changes

jtextfield

constructor actionperformed

constructor jtextfield

text north borderlayout

jtextfield center

note:

//instance variable for text field

jtextfield textfield;
fileio(){

text = new jlabel("text to save to file:");

clicked = new

jlabel("text retrieved from file:");

button = new jbutton("click me");

button.addactionlistener(this);

clickbutton = new jbutton("click again");

clickbutton.addactionlistener(this);

//text field instantiation

textfield = new jtextfield(20);

panel = new jpanel();

panel.setlayout(new borderlayout());

panel.setbackground(color.white);

getcontentpane().add(panel);

//adjustments to layout to add text field

panel.add("north", text);

panel.add("center", textfield);

panel.add("south", button);

}
method changes

actionperformedfileinputstreamfileoutputstream
 object source = event.getsource();

if(source == button){

//variable to display text read from file

string s = null;

if(_clickmemode){

try{

//code to write to file

string text = textfield.gettext();

byte b[] = text.getbytes();

string outputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file outputfile = new file(outputfilename);

fileoutputstream out = new

fileoutputstream(outputfile);

out.write(b);

out.close();

//code to read from file

string inputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file inputfile = new file(inputfilename);

fileinputstream in = new
 fileinputstream(inputfile);

byte bt[] = new

byte[(int)inputfile.length()];

in.read(bt);

s = new string(bt);

in.close();

}catch(java.io.ioexception e){

system.out.println("cannot access text.txt");

//clear text field

textfield.settext("");

//display text read from file

text.settext("text retrieved from file:");

textfield.settext(s);

button.settext("click again");

_clickmemode = false;

} else {

//save text to file

text.settext("text to save to file:");

textfield.settext("");

button.settext("click me");

_clickmemode = true;

textfield

string text = textfield.gettext();

 byte b[] = text.getbytes();

filefileoutputstream

string outputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file outputfile = new file(outputfilename);

fileoutputstream out = new

fileoutputstream(outputfile);

fileoutputstreamfile
out.write(b);

out.close();

filefileinputstream
string inputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file inputfile = new file(inputfilename);

fileinputstream out = new

fileinputstream(inputfile);

byte
byte bt[] = new byte[(int)inputfile.length()];

in.read(bt);

stringlabelfileinputstream
string s = new string(bt);
 label.settext(s);

in.close();
system properties

system.getpropertysystemfile.separatorchar

system.getpropertyuser.homefile.separatorchar + "home" +

file.separatorchar + "monicap")

file.separatorchar

java.io.file.separatorcharfile.separator

/home/monicap/text.tx

t\home\monicap\text.txtfile.separatorchar + "home" +

file.separatorchar + "monicap" + file.separatorchar +

"text.txt"

exception handling

java.lang.exceptionjava.lang.runtimeexception

actionperformedtrycatchjava.lang.ioexception

java.lang.ioexception

java.lang.throwable
trycatchjava.io.ioexception

actionperformedjava.io.ioexception
public int acomputationmethod(int number1,

int number2)

throws illegalvalueexception{

//body of method

note:

tostringprintstacktrace

//do this during development

}catch(java.io.ioexception e){

system.out.println(e.tostring());

system.out.println(e.printstacktrace());

//but deploy it like this

}catch(java.io.ioexception e){

system.out.println("cannot access text.txt");

trycatchcannot read text.txtcannot write text.txt

file access by applets

constructoractionperformed

• writing:textfieldout.write

• reading:

public void actionperformed(actionevent event){

object source = event.getsource();

if(source == button){

//variable to display text read from file

string s = null;

if(_clickmemode){

try{

//code to write to file

string text = textfield.gettext();

string outputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file outputfile = new file(outputfilename);

filewriter out = new

filewriter(outputfile);

out.write(text);

out.close();

//code to read from file

string inputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";
 file inputfile = new file(inputfilename);

filereader in = new filereader(inputfile);

char c[] = new

char[(char)inputfile.length()];

in.read(c);

s = new string(c);

in.close();

}catch(java.io.ioexception e){

system.out.println("cannot access text.txt");

//clear text field

textfield.settext("");

//display text read from file

text.settext("text retrieved from file:");

textfield.settext(s);

button.settext("click again");

_clickmemode = false;

} else {

//save text to file

text.settext("text to save to file:");

textfield.settext("");

button.settext("click me");

_clickmemode = true;

granting applets permission

click me
fileuiappltext.txttext.txt

creating a policy file

grant {

permission java.util.propertypermission

"user.home", "read";

permission java.io.filepermission

"${user.home}/text.txt", "read,write";

};
running an applet with a policy file

polfilefileio.htmlfileioappl
appletviewer -j-djava.security.policy=polfile fileio.html

note:

fileio.htmlfileioappl
<html>

<body>

<applet code=fileioappl.class width=200 height=100>

</applet>

</body>

</html>

restricting applications

java -djava.security.manager
 -djava.security.policy=apppolfile fileio

grant {

permission java.awt.awtpermission

"accesseventqueue";

permission java.awt.awtpermission

"showwindowwithoutwarningbanner";

permission java.util.propertypermission

"user.home", "read";

permission java.io.filepermission

"${user.home}/text.txt", "read,write";

};

file access by servlets

exampservlet.java

import java.io.*;

import javax.servlet.*;
import javax.servlet.http.*;

public class fileioservlet extends httpservlet {

public void dopost(httpservletrequest request,

httpservletresponse response)

throws servletexception, ioexception

response.setcontenttype("text/html");

printwriter out = response.getwriter();

out.println("<title>example<title>" +

"<body bgcolor=ffffff>");

out.println("<h2>button clicked</h2>");

string data = request.getparameter("data");

if(data != null){

out.println("<strong>text from

form:</strong>");

out.println(data);

} else {

out.println("no text entered.");

try{

//code to write to file

string outputfilename=

system.getproperty("user.home",
 file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file outputfile = new file(outputfilename);

filewriter fout = new filewriter(outputfile);

fout.write(data);

fout.close();

//code to read from file

string inputfilename =

system.getproperty("user.home",

file.separatorchar + "home" +

file.separatorchar + "monicap") +

file.separatorchar + "text.txt";

file inputfile = new file(inputfilename);

filereader fin = new

filereader(inputfile);

char c[] = new

char[(char)inputfile.length()];

int i;

i = fin.read(c);

string s = new string(c);

out.println("<p>

<strong>text from file:</strong>");

out.println(s);

fin.close();

}catch(java.io.ioexception e){

system.out.println("cannot access text.txt");

}
 out.println("<p>return to

<a href="../simplehtml.html">form</a>");

out.close();

appending

more information

lesson 7: database access and permissions

o
 •

database setup

jdbcjdbcjdbc.odbcjdbc.odbcoracleoci7.3.4

create database table

table dba (

text varchar2(100),

primary key (text)

database access by applications

click me

click me
establishing a database connection

drivermanagerconnectionstrings_driver_url

_urljdbc:oracle:thinusernamepassword

private connection c;

final static private string _driver =

"oracle.jdbc.driver.oracledriver";

final static private string _url =

"jdbc:oracle:thin:username/password@(description=(

address_list=(address=(protocol=tcp)

(host=developer)(port=1521)))

(source_route=yes)(connect_data=(sid=jdcsid)))";

actionperforme

class.forname(_driver

)drivermanager.getconnectiontrycatchcatch

class.forname(_driver);java.lang.classnotfoundexceptionc =
drivermanager.getconnection(_url);java.sql.sqlexception

public void actionperformed(actionevent event){

try{

//load the driver

class.forname(_driver);

//establish database connection

c = drivermanager.getconnection(_url);

}catch (java.lang.classnotfoundexception e){

system.out.println("cannot find driver class");

system.exit(1);

}catch (java.sql.sqlexception e){

system.out.println("cannot get connection");

system.exit(1);

}
final and private variables

privatefinal

finalfinalfinal

privateprivateprivateprivate

writing and reading data

statementconnectionstatementstringexecuteupdatestatement
object source = event.getsource();

if(source == button){

jtextarea displaytext = new jtextarea();

try{

//code to write to database

string thetext = textfield.gettext();

 statement stmt = c.createstatement();

string updatestring = "insert into dba values

('" + thetext + "')";

int count = stmt.executeupdate(updatestring);

stringstringthetext

resultsetexecutequerystatementresultsetresultsetdisplaytext

//code to read from database

resultset results = stmt.executequery(

"select text from dba ");

while(results.next()){

string s = results.getstring("text");

displaytext.append(s + "\n");

stmt.close();

} catch(java.sql.sqlexception e){

system.out.println(e.tostring());

//display text read from database

panel.removeall();

panel.add("north", clicked);

panel.add("center", displaytext);

panel.add("south", clickbutton);

panel.validate();

panel.repaint();

database access by applets

jdbc driver

starting the applet:dbaappl.htmldbaappl

<html>

<body>

<applet code=dbaappl.class

width=200

height=100>

</applet>

</body>

</html>

appletviewer dbaappl.html

locating the database driver:drivermanagerclick me

cannot find driver

appletviewer dbaappl.html

reading a stack trace:click me

java.security.accesscontrolexception: access denied

(java.net.socketpermission developer resolve)

socketpermissiondeveloper

grant {
 permission java.net.socketpermission "developer",

"resolve";

"accessclassinpackage.sun.jdbc.odbc";

};

dbaapplpol

appletviewer -j-djava.security.policy=dbaapplpol

dbaappl.html

java.security.accesscontrolexception: access denied

(java.net.socketpermission

129.144.176.176:1521 connect,resolve)

socketpermissiondeveloper

dbaapplpol

grant {

permission java.net.socketpermission "developer",

"resolve";

permission java.net.socketpermission

"129.144.176.176:1521", "connect,resolve";

};

appletviewer -j-djava.security.policy=dbaapplpol

dbaappl.html
jdbc-odbc bridge with odbc driver

drivermanager
start the applet:dbaodb.htmldbaodbappl

<html>

<body>

<applet code=dbaodbappl.class

width=200

height=100>

</applet>

</body>

</html>

appletviewer dbaodb.html

reading a stack trace:click me

java.security.accesscontrolexception: access denied

(java.lang.runtimepermission

accessclassinpackage.sun.jdbc.odbc )

runtimepermissionsun.jdbc.odbc

grant {

permission java.lang.runtimepermission

"accessclassinpackage.sun.jdbc.odbc";

};

dbaodbpol

appletviewer -j-djava.security.policy=dbaodbpol

dbaodb.html

java.security.accesscontrolexception:
 access denied (java.lang.runtimepermission

file.encoding read)

dbaodbpol
grant {

permission java.lang.runtimepermission

"accessclassinpackage.sun.jdbc.odbc";

permission java.util.propertypermission

"file.encoding", "read";

};

appletviewer -j-djava.security.policy=dbaodbpol

dbaodb.html

database access by servlets

fileioservlet

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;
import java.sql.*;

import java.net.*;

import java.io.*;

public class dbaservlet extends httpservlet {

private connection c;

final static private string _driver =

"sun.jdbc.odbc.jdbcodbcdriver";

final static private string _user = "username";

final static private string _pass = "password";

final static private string

_url = "jdbc:odbc:jdc";

public void dopost(httpservletrequest request,

httpservletresponse response)

throws servletexception, ioexception{

response.setcontenttype("text/html");

printwriter out = response.getwriter();

out.println("<title>example<title>" +

"<body bgcolor=ffffff>");

out.println("<h2>button clicked</h2>");

string data = request.getparameter("data");

if(data != null){

out.println("<strong>text from
 form:</strong>");

out.println(data);

} else {

out.println("no text entered.");

//establish database connection

try{

class.forname (_driver);

c = drivermanager.getconnection(_url,

_user,

_pass);

} catch (exception e) {

e.printstacktrace();

system.exit(1);

try{

//code to write to database

statement stmt = c.createstatement();

string updatestring = "insert into dba " +

"values ('" + data + "')";

int count = stmt.executeupdate(updatestring);

//code to read from database

resultset results = stmt.executequery(

"select text from dba ");

while(results.next()){

string s = results.getstring("text");
 out.println("<br>

<strong>text from database:</strong>");

out.println(s);

stmt.close();

}catch(java.sql.sqlexception e){

system.out.println(e.tostring());

out.println("<p>return to

<a href="../dbahtml.html">form</a>");

out.close();

more information

lesson 8: remote method invocation

•
 o

about the example

program behavior

click meclick mermiclient2rmiclient1

rmiclient1rmiclient2click mermiclient2click me
file summary

• senddataremoteserver

• getdataremoteserver

• send.javasenddatagetdata

• senddatagetdata

grant {

permission java.net.socketpermission

"*:1024-65535",

"connect,accept,resolve";

permission java.net.socketpermission

"*:80", "connect";

permission java.awt.awtpermission

"accesseventqueue";

permission java.awt.awtpermission
 "showwindowwithoutwarningbanner";

};
compile the example

zeldazeldapublic_htmlzelda

unix:

cd /home/zelda/classes

javac send.java

javac remoteserver.java

javac rmiclient2.java

javac rmiclient1.java

rmic -d . remoteserver

cp remoteserver*.class /home/zelda/public_html/classes

cp send.class /home/zelda/public_html/classes
win32:

cd \home\zelda\classes

javac send.java

javac remoteserver.java

javac rmiclient2.java

javac rmiclient1.java

rmic -d . remoteserver

copy remoteserver*.class \home\zelda\public_html\classes

copy send.class \home\zelda\public_html\classes

javacremoteserversendjavacrmiclient2javacrmiclient1

rmi

remoteserve
rclassname_stub.classclassname_skel.classremoteserver

remoteserve

rskelstub/home/zelda/public_html/classespublic_html

sendrmiclient1rmiclient2public_html

• rmiclient1

• rmiclient2

start the rmi registry

rmiregistryclasspathstubskel

classpathrmiregistry 4444 &

unix:

cd /home/zelda/public_html/classes

unsetenv classpath
rmiregistry &
win32:

cd \home\zelda\public_html\classes

set classpath=

start rmiregistry

note:classpath

run the remoteserver server object

remoteserverrmiclient1rmiclient2

remoteserver/home/zelda/public_html/classes

java-djava
unix:

cd /home/zelda/public_html/classes

java

-djava.rmi.server.codebase=http://kq6py/~zelda/classes

-djava.rmi.server.hostname=kq6py.eng.sun.com

-djava.security.policy=java.policy remoteserver
win32:

cd \home\zelda\public_html\classes

java -djava.rmi.server.codebase=file:

c:\home\zelda\public_html\classes

-djava.rmi.server.hostname=kq6py.eng.sun.com

-djava.security.policy=java.policy remoteserver

• java.rmi.server.codebase

• java.rmi.server.hostname
 • java.rmi.security.policy

• remoteserver

run the rmiclient1 program

rmiclient1/home/zelda/classes

java-djava
unix:

cd /home/zelda/classes

java -djava.rmi.server.codebase=

http://kq6py/~zelda/classes/

-djava.security.policy=java.policy

rmiclient1 kq6py.eng.sun.com
win32:

cd \home\zelda\classes

java -djava.rmi.server.codebase=

file:c:\home\zelda\classes\

-djava.security.policy=java.policy

rmiclient1 kq6py.eng.sun.com

• java.rmi.server.codebase

• java.security.policy

• rmiclient1kq6py

run rmiclient2

rmiclient2/home/zelda/classes
java-djava
unix:

cd /home/zelda/classes

java -djava.rmi.server.codebase=

http://kq6py/~zelda/classes

-djava.security.policy=java.policy

rmiclient2 kq6py.eng.sun.com
win32:

cd \home\zelda\classes

java -djava.rmi.server.codebase=

file:c:\home\zelda\public_html\classes

-djava.security.policy=java.policy

rmiclient2 kq6py.eng.sun.com

• java.rmi.server.codebase

• java.rmi.server.hostname

• java.rmi.security.policy

• rmiclient2

remoteserver class

unicastremoteobjectsenddatagetdatasend

unicastremoteobjectjava.lang.object

class remoteserver extends unicastremoteobject

implements send {

string text;

public remoteserver() throws remoteexception {

 super();

public void senddata(string gottext){

text = gottext;

public string getdata(){

return text;

mainrmisecuritymanagermainremoteserverkq6pysend

kq6py:4444

tryremoteservernamenaming.rebind(name, remoteserver);

public static void main(string[] args){

if(system.getsecuritymanager() == null) {

system.setsecuritymanager(new

rmisecuritymanager());

string name = "//kq6py.eng.sun.com/send";

try {

send remoteserver = new remoteserver();

naming.rebind(name, remoteserver);

system.out.println("remoteserver bound");

} catch (java.rmi.remoteexception e) {

system.out.println("cannot create

remote server object");

} catch (java.net.malformedurlexception e) {

system.out.println("cannot look up
 server object");

note:remoteserversendsendremoteserver

send interface

remoteserver
public interface send extends remote {

public void senddata(string text)

throws remoteexception;

public string getdata() throws remoteexception;

rmiclient1 class

actionperformedmain
actionperformed method

actionperformedremoteserver.senddata
public void actionperformed(actionevent event){

object source = event.getsource();

if(source == button){

//send data over socket

string text = textfield.gettext();

try{

send.senddata(text);
 } catch (java.rmi.remoteexception e) {

system.out.println("cannot send data to server");

textfield.settext(new string(""));

}
main method

mai

rmisecuritymanagernameremoteservernaming.lookupremoteserver

rmiclient1 frame = new rmiclient1();

if(system.getsecuritymanager() == null) {

system.setsecuritymanager(new rmisecuritymanager());

try {

//args[0] contains name of server where send runs

string name = "//" + args[0] + "/send";

send = ((send) naming.lookup(name));

} catch (java.rmi.notboundexception e) {

system.out.println("cannot look up

remote server object");

} catch(java.rmi.remoteexception e){

system.out.println("cannot look up

remote server object");

} catch(java.net.malformedurlexception e) {
 system.out.println("cannot look up

remote server object");

rmiclient2 class

actionperformedmain
actionperformed method

actionperformedremoteserver.getdatatextarea
public void actionperformed(actionevent event) {

object source = event.getsource();

if(source == button){

try{

string text = send.getdata();

textarea.append(text);

} catch (java.rmi.remoteexception e) {

system.out.println("cannot send data

to server");

}
main method

mai

rmisecuritymanage

rnameremoteserverargs[0]naming.lookupremoteserver
 rmiclient2 frame = new rmiclient2();

if(system.getsecuritymanager() == null) {

system.setsecuritymanager(new rmisecuritymanager());

try {

string name = "//" + args[0] + "/send";

send = ((send) naming.lookup(name));

} catch (java.rmi.notboundexception e) {

system.out.println("cannot look up remote

server object");

} catch(java.rmi.remoteexception e){

system.out.println("cannot look up remote

server object");

} catch(java.net.malformedurlexception e) {

system.out.println("cannot look up remote

server object");

more information

in closing

monica pawlan is a staff writer on the jdc team. she has a background
in 2d and 3d graphics, security, database products, and loves to
explore emerging technologies.