Saturday, 22 May 2010

Game Design Document Example

Introduction

In One Sentence

Collect goo by popping Schwamps before they explode and cover your view.

Abstract

Schwamp is a classical high-score puzzle game where you have to pop Gooy little creatures that appear on screen before they explode in your face. Schwamps appear quickly and you have to decide whether to merge them before popping for combo points, or if they will explode before you manage to pop them. The Schwamps have several different colors and merging different colors will prove lethal.

The name comes from the German Schwamm meaning sponge.

Target Platform

The target platform is the GP2X and Wiz hand-held consoles with a tactile touch screen. Also, the iPhone could be considered although some testing is required as the finger on the touch screen usually covers a lot of view area.

Target Audience

The core players are casual gamers looking for a quick game of fun at a moderate pace. Ages 25 and up. Hard-core teenage gamers will most likely not find it appealing.

Game Mechanics

The game is about clearing the screen for Schwamps before they explode and cover the view. The goo from the Schwamps is collected to advance to the next level.

Winning and Loosing Conditions

Should the player fill up the Schwamp bar he passes the level. If the view is sufficiently cluttered with exploded Schwamps, the game is over. This clutter needs to be tweaked appropriately.

Scoring

Each level has a list of the best players on that level. Players are ranked by two factors, speed of completing the level, and points scored on the level. Combining same-color Schwamps increases points for popping said Schwamp at an exponential rate for each merger. This to promote merging instead of simply popping. Points are also awarded for finishing within a certain time limit defined by the level designer. There is a worst time where has more time passed, no points are awarded, and a best time where completing before said time will yield full time-points. Finishing anywhere between these two time limits gives a linear interpolation of the points between the two times. These points are added to the total score for each level.

Score is reset between levels and the progression is unlocking new levels by completing the previous.

Player Controls

The player clicks on a Schwamp to have it pop into goo droplets, which fall (without collision with other Schwamps) to the bottom of the screen into the tract that guides them into the Schwamp bar on the right of the screen.

The player can also drag Schwamps around. Upon releasing a dragging Schwamp it comes to a halt again, i.e. the player cannot send the Schwamp floating around.

The player can clean the view by dragging a normal sponge as if he was wiping the screen clean. See special features below.

Schwamps

The Schwamps are wobbly creatures of various sizes floating very slowly around the screen. The floating is so slow that it can take several seconds before two Schwamps float into each other. The closer a Schwamp is to exploding the more it will shake erratically. This functions as a signal to the player. If Schwamps of different colors get to close to each other they will explode sooner, i.e. their internal timer counts faster when close to other colors, proportional to the distance between them. The bigger the Schwamp, the faster this timer also counts (see Merge Schwamps below.) Schwamps appear on the screen where there is room for them. So no Schwamp will directly appear on top of another Schwamp causing "an accident." Should there be no room for a Schwamp that Schwamp is skipped, and timers are still reset for next Schwamp to appear.

Goo

The goo comes from popped Schwamps. It falls with gravity to the bottom and enters the tract, where they start rolling into the Schwamp bar pushing the rest of the goo further up. To complete a level, the Schwamp bar has to be filled up with goo to a marker defined by that level.

Schwamp Bar

The Schwamp bar collects all the goo which has come from popping Schwamps. There is a marker on the Schwamp bar indicating how much goo is needed to pass the level.

Special Features

Sponge

Sometimes a normal sponge pops up. This sponge can be dragged around to clean the screen from exploded Schwamps that have cluttered the view. I.e. this will help you clean up the mess should you have "dropped your guard for a second" and not manage to pop Schwamps before they exploded covering the player's view. This is the player's only way to recover, i.e. there are no extra lives. The sponge disappears after a predefined amount of time for that level. See Levels below.

Merge Schwamps

Schwamps of the same color can be merged into larger Schwamps. This gives in total more goo then popping them individually. But it requires they are on screen longer so the player risks having them explode in his face before managing to merge them. There is also an added risk of touching one of the other-colored Schwamps, in which case both will explode in your face. When merging Schwamps, the new Schwamp's internal explosion timer is set to the larger of the two, and will count down faster, the bigger the Schwamp (speed to be tweaked.)

Levels

The levels consist of randomly generated Schwamps based on some defined parameters for each level. These parameters are:

  • How much goo is needed to pass the level. This is indicated as a marker on the Schwamp bar
  • How much time it takes a Schwamp to explode
  • Worst-time, at which point player get's no time-bonus for completing
  • Best-time, completing faster then this time player receives maximum time-bonus
  • maximum time-bonus. How many points are awarded should player complete within best-time
  • Which colors are on this level
  • Probability mass function (pmf) for first appearing Schwamp color
  • Pmf for next Schwamp color given previous Schwamp color
  • Which sizes Schwamps are on the level
  • Pmf for Schwamp size appearing
  • Probability of a normal sponge appearing
  • Duration of a normal sponge, should it appear

These parameters should be enough to create a variety of levels, as well as a variety of types of levels, i.e. from quickly appearing tiny schwamps that explode right away to slower levels where you can merge Schwamps to get more combo points, etc.

(The levels themselves are not described in this document. If you feel this should be done, go ahead and add them.)

Storyboard

Dragging to merge Schwamps of same color into bigger Schwamps before popping.


sketch_11.pngSchwamps of various colors floating around.
sketch_12.pngClick…
sketch_13.png… and Drag Schwamp.
sketch_14.pngMerge with other Schwamps of same color to make a bigger Schwamp.
sketch_15.pngMake sure not to collide with other colors as different color Schwamps too close to each other will explode.
sketch_16.pngClick…
sketch_17.png… and release to pop Schwamp.
sketch_18.pngSchwamp-goo falls to the bottom and collects in the Schwamp bar.

Older Concept Art


sketch_01.pngGame screen with Schwamp-o-meter on the right and funnel at the bottom to collect the gooie mass that comes from popping the Schwamp.
sketch_02.pngA Schwamp appears.
sketch_03.pngPlayer pops Schwamp with stylus.
sketch_04.pngSchwamp dissolves into gooy liquid and gets collected in the Schwamp bar.
sketch_05.pngTwo Schwamps have appeared. The upper Schwamp has not been popped for a longer period of time and is about to explode.
sketch_06.pngThe Schwamp explodes and clutters parts of the player's view.
sketch_07.pngA sponge appears to rescue the player. These appear at random intervals.
sketch_08.pngThe player can use the sponge to wipe clean the screen before other Schwamps explodes.

Game Screens

A list of the game screens. Notice there is no help screen, as this should be the first level as an in-game tutorial.

  • Intro
  • Main menu
  • Level select
  • In-game
  • Enter high-score
  • High-score
  • Credits (when exiting game)

Flow

screen_flow.png

The player can at any point return to the menu, but for simplicity, this is not figured in the figure above.

Visual Style

The Schwamps are wobbly jelly like colorful creatures with eyes to give them a cute personality. The eyes will make them appear to be aware of their surrounding environment. E.g. should a neighboring Schwamp be popped, their attention will be focused on this Schwamp, and maybe even watch in dismay as the goo falls to the bottom of the screen. The level consists of a cold-steel rail/tract/funnel which will collect the goo, and the poor creatures are to be collected inside this dirty glass and steel container. For extra empathy, the eyes will also be contained within the steel-container. The eyes will have a "help me i'm trapped" or "why me?" look.

Concept Art

concept.png

Audio Style

Cartoony sounds!

Assets

  • main-menu music
  • in-game music
  • level selection music
  • high-score music
  • level start jingle
  • game-over jingle
  • menu select item click
  • Popping sound
  • Exploding sound (Schwamp exploding)
  • Droplets landing
  • Sucked into Schwamp bar
  • Schwamp speech (in non-existing language in a high-pitched cartoony voice)
    • merging
    • random rant. A couple of varying words said at random times
    • scared (one was popped close by)
    • close to exploding cry

Java Programming Language

Java (programming language)

From Wikipedia, the free encyclopedia

Java
Java logo.svg
ParadigmObject-oriented,structured, imperative
Appeared in1995
Designed bySun Microsystems (Now owned by Oracle Corporation)
DeveloperJames Gosling & Sun Microsystems
Stable releaseJava Standard Edition 6 (1.6.0_20) (April 15, 2010; 37 days ago)
Typing disciplineStatic, strong, safe,nominative, manifest
Major implementationsNumerous
DialectsGeneric Java, Pizza
Influenced byAda 83, C++, C#,[1] Delphi Object Pascal,[2] Eiffel,[3]Generic Java, Mesa,[4]Modula-3,[5] Objective-C,[6] UCSD Pascal,[7][8]Smalltalk
InfluencedAda 2005, C#, Clojure, D,ECMAScript, Groovy, J#,PHP, Scala, JavaScript,Python, BeanShell
OSCross-platform (multi-platform)
LicenseGNU General Public License / Java Community Process
Usual file extensions.java, .class, .jar
Websitejava.sun.com
Wikibooks logo Java Programming at Wikibooks
Duke, the Java mascot

Java is a programming language originally developed by James Gosling at Sun Microsystems (which is now a subsidiary of Oracle Corporation) and released in 1995 as a core component of Sun Microsystems' Java platform. The language derives much of its syntax from Cand C++ but has a simpler object model and fewer low-level facilities. Java applications are typically compiled to bytecode (class file) that can run on any Java Virtual Machine (JVM) regardless of computer architecture. Java is general-purpose, concurrent, class-based, and object-oriented, and is specifically designed to have as few implementation dependencies as possible. It is intended to let application developers "write once, run anywhere". Java is considered by many as one of the most influential programming languages of the 20th century, and is widely used from application software to web applications.[9][10]

The original and reference implementation Java compilers, virtual machines, and class libraries were developed by Sun from 1995. As of May 2007, in compliance with the specifications of the Java Community Process, Sun relicensed most of their Java technologies under the GNU General Public License. Others have also developed alternative implementations of these Sun technologies, such as the GNU Compiler for Java and GNU Classpath.

Contents

[hide]

[edit]History

James Gosling initiated the Java language project in June 1991 for use in one of his many set-top box projects.[11] Java was originally designed for interactive television, but it was too advanced.[12] The language, initially called Oak after an oak tree that stood outside Gosling's office, also went by the name Green and ended up later renamed as Java, from a list of random words.[13] Gosling aimed to implement a virtual machine and a language that had a familiar C/C++ style of notation.[14]

Sun Microsystems released the first public implementation as Java 1.0 in 1995. It promised "Write Once, Run Anywhere" (WORA), providing no-cost run-times on popular platforms. Fairly secure and featuring configurable security, it allowed network- and file-access restrictions. Major web browsers soon incorporated the ability to run Java applets within web pages, and Java quickly became popular. With the advent of Java 2 (released initially as J2SE 1.2 in December 1998), new versions had multiple configurations built for different types of platforms. For example, J2EE targeted enterprise applications and the greatly stripped-down version J2ME for mobile applications (Mobile Java). J2SE designated the Standard Edition. In 2006, for marketing purposes, Sun renamed new J2versions as Java EE, Java ME, and Java SE, respectively.

In 1997, Sun Microsystems approached the ISO/IEC JTC1 standards body and later the Ecma International to formalize Java, but it soon withdrew from the process.[15] Java remains a de facto standard, controlled through the Java Community Process.[16] At one time, Sun made most of its Java implementations available without charge, despite their proprietary software status. Sun generated revenue from Java through the selling of licenses for specialized products such as the Java Enterprise System. Sun distinguishes between its Software Development Kit (SDK) and Runtime Environment (JRE) (a subset of the SDK); the primary distinction involves the JRE's lack of the compiler, utility programs, and header files.

On November 13, 2006, Sun released much of Java as open source software under the terms of the GNU General Public License (GPL). On May 8, 2007, Sun finished the process, making all of Java's core code available under free software/open-source distribution terms, aside from a small portion of code to which Sun did not hold the copyright.[17]

Sun's vice-president Rich Green has said that Sun's ideal role with regards to Java is as an "evangelist."[18]

[edit]Principles

There were five primary goals in the creation of the Java language:[19]

  1. It should be "simple, object oriented, and familiar".
  2. It should be "robust and secure".
  3. It should be "architecture neutral and portable".
  4. It should execute with "high performance".
  5. It should be "interpreted, threaded, and dynamic".

[edit]Practices

[edit]Java Platform

One characteristic of Java is portability, which means that computer programs written in the Java language must run similarly on any supported hardware/operating-system platform. This is achieved by compiling the Java language code to an intermediate representation called Java bytecode, instead of directly to platform-specific machine code. Java bytecode instructions are analogous to machine code, but are intended to be interpreted by a virtual machine (VM) written specifically for the host hardware. End-users commonly use a Java Runtime Environment (JRE) installed on their own machine for standalone Java applications, or in a Web browser for Java applets.

Standardized libraries provide a generic way to access host-specific features such as graphics, threading and networking.

A major benefit of using bytecode is porting. However, the overhead of interpretation means that interpreted programs almost always run more slowly than programs compiled to native executables would. Just-in-Time compilers were introduced from an early stage that compile bytecodes to machine code during runtime. Over the years, this JVM built-in feature has been optimized to a point where the JVM's performance competes with natively compiled C code.[citation needed]

[edit]Implementations

Sun Microsystems officially licenses the Java Standard Edition platform for Linux,[20] Mac OS X,[21] and Solaris. Although in the past Sun has licensed Java to Microsoft, the license has expired and has not been renewed.[22] Through a network of third-party vendors and licensees,[23] alternative Java environments are available for these and other platforms.

Sun's trademark license for usage of the Java brand insists that all implementations be "compatible". This resulted in a legal dispute with Microsoft after Sun claimed that the Microsoft implementation did not support RMI or JNI and had added platform-specific features of their own. Sun sued in 1997, and in 2001 won a settlement of $20 million as well as a court order enforcing the terms of the license from Sun.[24] As a result, Microsoft no longer ships Java with Windows, and in recent versions of Windows, Internet Explorer cannot support Java applets without a third-party plugin. Sun, and others, have made available free Java run-time systems for those and other versions of Windows.

Platform-independent Java is essential to the Java EE strategy, and an even more rigorous validation is required to certify an implementation. This environment enables portable server-side applications, such as Web services, Java Servlets, and Enterprise JavaBeans, as well as with embedded systems based on OSGi, using Embedded Java environments. Through the new GlassFish project, Sun is working to create a fully functional, unified open source implementation of the Java EE technologies.

Sun also distributes a superset of the JRE called the Java Development Kit (commonly known as the JDK), which includes development tools such as the Java compiler, Javadoc, Jar anddebugger.

[edit]Performance

Programs written in Java have a reputation for being slower and requiring more memory than those written in some other languages.[25] However, Java programs' execution speed improved significantly with the introduction of Just-in-time compilation in 1997/1998 for Java 1.1,[26][27][28] the addition of language features supporting better code analysis (such as inner classes, StringBuffer class, optional assertions, etc.), and optimizations in the Java Virtual Machine itself, such as HotSpot becoming the default for Sun's JVM in 2000.

To boost even further the speed performances that can be achieved using the Java language Systronix made JStik[29], a microcontroller based on the aJile Systems[30] line of embeddedJava processors. In addition, the widely used ARM family of CPUs has hardware support for executing Java bytecode through its Jazelle option.

[edit]Automatic memory management

Java uses an automatic garbage collector to manage memory in the object lifecycle. The programmer determines when objects are created, and the Java runtime is responsible for recovering the memory once objects are no longer in use. Once no references to an object remain, the unreachable memory becomes eligible to be freed automatically by the garbage collector. Something similar to a memory leak may still occur if a programmer's code holds a reference to an object that is no longer needed, typically when objects that are no longer needed are stored in containers that are still in use. If methods for a nonexistent object are called, a "null pointer exception" is thrown.[31][32]

One of the ideas behind Java's automatic memory management model is that programmers be spared the burden of having to perform manual memory management. In some languages memory for the creation of objects is implicitly allocated on the stack, or explicitly allocated and deallocated from the heap. Either way, the responsibility of managing memory resides with the programmer. If the program does not deallocate an object, a memory leak occurs. If the program attempts to access or deallocate memory that has already been deallocated, the result is undefined and difficult to predict, and the program is likely to become unstable and/or crash. This can be partially remedied by the use of smart pointers, but these add overhead and complexity. Note that garbage collection does not prevent 'logical' memory leaks, i.e. those where the memory is still referenced but never used.

Garbage collection may happen at any time. Ideally, it will occur when a program is idle. It is guaranteed to be triggered if there is insufficient free memory on the heap to allocate a new object; this can cause a program to stall momentarily. Explicit memory management is not possible in Java.

Java does not support C/C++ style pointer arithmetic, where object addresses and unsigned integers (usually long integers) can be used interchangeably. This allows the garbage collector to relocate referenced objects, and ensures type safety and security.

As in C++ and some other object-oriented languages, variables of Java's primitive data types are not objects. Values of primitive types are either stored directly in fields (for objects) or on the stack (for methods) rather than on the heap, as commonly true for objects (but see Escape analysis). This was a conscious decision by Java's designers for performance reasons. Because of this, Java was not considered to be a pure object-oriented programming language. However, as of Java 5.0, autoboxing enables programmers to proceed as if primitive types were instances of their wrapper class.

[edit]Syntax

The syntax of Java is largely derived from C++. Unlike C++, which combines the syntax for structured, generic, and object-oriented programming, Java was built almost exclusively as an object oriented language. All code is written inside a class and everything is an object, with the exception of the intrinsic data types (ordinal and real numbers, boolean values, and characters), which are not classes for performance reasons.

Java suppresses several features (such as operator overloading and multiple inheritance) for classes in order to simplify the language and to prevent possible errors and anti-pattern design.

Java uses similar commenting methods to C++. There are three different styles of comment: a single line style marked with two slashes (//), a multiple line style opened with a slash asterisk (/*) and closed with an asterisk slash (*/) and the Javadoc commenting style opened with a slash and two asterisks (/**) and closed with an asterisk slash (*/). The Javadoc style of commenting allows the user to run the Javadoc executable to compile documentation for the program.

Example:

//This is an example of a single line comment using two slashes   /* This is an example of a multiple line comment using the slash    and asterisk. This type of comment can be used to hold a lot of information    or deactivate code but it is very important to remember to close the comment. */   /** This is an example of a multiple line Javadoc comment     which allows compilation from Javadoc of this comment. */ 

[edit]Examples

[edit]Hello world

The traditional Hello world program can be written in Java as:

// Outputs "Hello, world!" and then exits public class HelloWorld {    public static void main(String[] args) {        System.out.println("Hello, world!");    } } 

Source files must be named after the public class they contain, appending the suffix .java, for example, HelloWorld.java. It must first be compiled into bytecode, using a Java compiler, producing a file named HelloWorld.class. Only then can it be executed, or 'launched'. The java source file may only contain one public class but can contain multiple classes with less than public access and any number of public inner classes.

A class that is not declared public may be stored in any .java file. The compiler will generate a class file for each class defined in the source file. The name of the class file is the name of the class, with .class appended. For class file generation, anonymous classes are treated as if their name were the concatenation of the name of their enclosing class, a $, and an integer.

The keyword public denotes that a method can be called from code in other classes, or that a class may be used by classes outside the class hierarchy. The class hierarchy is related to the name of the directory in which the .java file is.

The keyword static in front of a method indicates a static method, which is associated only with the class and not with any specific instance of that class. Only static methods can be invoked without a reference to an object. Static methods cannot access any method variables that are not static.

The keyword void indicates that the main method does not return any value to the caller. If a Java program is to exit with an error code, it must call System.exit() explicitly.

The method name "main" is not a keyword in the Java language. It is simply the name of the method the Java launcher calls to pass control to the program. Java classes that run in managed environments such as applets and Enterprise JavaBean do not use or need a main() method. A java program may contain multiple classes that have main methods, which means that the VM needs to be explicitly told which class to launch from.

The main method must accept an array of String objects. By convention, it is referenced as args although any other legal identifier name can be used. Since Java 5, the main method can also use variable arguments, in the form of public static void main(String... args), allowing the main method to be invoked with an arbitrary number ofString arguments. The effect of this alternate declaration is semantically identical (the args parameter is still an array of String objects), but allows an alternative syntax for creating and passing the array.

The Java launcher launches Java by loading a given class (specified on the command line or as an attribute in a JAR) and starting its public static void main(String[])method. Stand-alone programs must declare this method explicitly. The String[] args parameter is an array of String objects containing any arguments passed to the class. The parameters to main are often passed by means of a command line.

Printing is part of a Java standard library: The System class defines a public static field called out. The out object is an instance of the PrintStream class and provides many methods for printing data to standard out, including println(String) which also appends a new line to the passed string.

The string "Hello, world!" is automatically converted to a String object by the compiler.

[edit]A more comprehensive example

// OddEven.java import javax.swing.JOptionPane;   public class OddEven {     // "input" is the number that the user gives to the computer     private int input; // a whole number("int" means integer)       /*      * This is the constructor method. It gets called when an object of the OddEven type      * is being created.      */     public OddEven() {     /*      * Code not shown for simplicity.  In most Java programs constructors can initialize objects      * with default values, or create other objects that this object might use to perform its      * functions.  In some Java programs, the constructor may simply be an empty function if nothing      * needs to be initialized prior to the functioning of the object.  In this program's case, an      * empty constructor would suffice, even if it is empty. A constructor must exist, however if the      * user doesn't put one in then the compiler will create an empty one.      */     }       // This is the main method. It gets called when this class is run through a Java interpreter.     public static void main(String[] args) {         /*          * This line of code creates a new instance of this class called "number" (also known as an          * Object) and initializes it by calling the constructor.  The next line of code calls          * the "showDialog()" method, which brings up a prompt to ask you for a number          */         OddEven number = new OddEven();         number.showDialog();     }       public void showDialog() {         /*          * "try" makes sure nothing goes wrong. If something does,           * the interpreter skips to "catch" to see what it should do.          */         try {             /*              * The code below brings up a JOptionPane, which is a dialog box              * The String returned by the "showInputDialog()" method is converted into              * an integer, making the program treat it as a number instead of a word.              * After that, this method calls a second method, calculate() that will              * display either "Even" or "Odd."              */             input = Integer.parseInt(JOptionPane.showInputDialog("Please Enter A Number"));             calculate();         } catch (NumberFormatException e) {             /*              * Getting in the catch block means that there was a problem with the format of              * the number. Probably some letters were typed in instead of a number.              */             System.err.println("ERROR: Invalid input. Please type in a numerical value.");         }     }       /*      * When this gets called, it sends a message to the interpreter.       * The interpreter usually shows it on the command prompt (For Windows users)       * or the terminal (For Linux users).(Assuming it's open)      */     private void calculate() {         if (input % 2 == 0) {             System.out.println("Even");         } else {             System.out.println("Odd");         }     } } 
  • The import statement imports the JOptionPane class from the javax.swing package.
  • The OddEven class declares a single private field of type int named input. Every instance of the OddEven class has its own copy of the input field. The private declaration means that no other class can access (read or write) the input field.
  • OddEven() is a public constructor. Constructors have the same name as the enclosing class they are declared in, and unlike a method, have no return type. A constructor is used to initialize an object that is a newly created instance of the class.
  • The calculate() method is declared without the static keyword. This means that the method is invoked using a specific instance of the OddEven class. (The reference used to invoke the method is passed as an undeclared parameter of type OddEven named this.) The method tests the expression input % 2 == 0 using the if keyword to see if the remainder of dividing the input field belonging to the instance of the class by two is zero. If this expression is true, then it prints Even; if this expression is false it prints Odd. (Theinput field can be equivalently accessed as this.input, which explicitly uses the undeclared this parameter.)
  • OddEven number = new OddEven(); declares a local object reference variable in the main method named number. This variable can hold a reference to an object of typeOddEven. The declaration initializes number by first creating an instance of the OddEven class, using the new keyword and the OddEven() constructor, and then assigning this instance to the variable.
  • The statement number.showDialog(); calls the calculate method. The instance of OddEven object referenced by the number local variable is used to invoke the method and passed as the undeclared this parameter to the calculate method.
  • input = Integer.parseInt(JOptionPane.showInputDialog("Please Enter A Number")); is a statement that converts the type of String to the primitive data typeint by using a utility function in the primitive wrapper class Integer.

[edit]Special classes

[edit]Applet

Java applets are programs that are embedded in other applications, typically in a Web page displayed in a Web browser.

// Hello.java import javax.swing.JApplet; import java.awt.Graphics;   public class Hello extends JApplet {     public void paintComponent(Graphics g) {         g.drawString("Hello, world!", 65, 95);     }     } 

The import statements direct the Java compiler to include the javax.swing.JApplet and java.awt.Graphics classes in the compilation. The import statement allows these classes to be referenced in the source code using the simple class name (i.e. JApplet) instead of the fully qualified class name (i.e. javax.swing.JApplet).

The Hello class extends (subclasses) the JApplet (Java Applet) class; the JApplet class provides the framework for the host application to display and control the lifecycle of the applet. The JApplet class is a JComponent (Java Graphical Component) which provides the applet with the capability to display a graphical user interface (GUI) and respond to userevents.

The Hello class overrides the paintComponent(Graphics) method inherited from the Container superclass to provide the code to display the applet. ThepaintComponent() method is passed a Graphics object that contains the graphic context used to display the applet. The paintComponent() method calls the graphic contextdrawString(String, int, int) method to display the "Hello, world!" string at a pixel offset of (65, 95) from the upper-left corner in the applet's display.

 "http://www.w3.org/TR/html4/strict.dtd">  <html>   <head>     <title>Hello World Applet</title>   </head>   <body>     <applet code="Hello" width="200" height="200">     </applet>   </body> </html> 

An applet is placed in an HTML document using the HTML element. The applet tag has three attributes set: code="Hello" specifies the name of the JApplet class andwidth="200" height="200" sets the pixel width and height of the applet. Applets may also be embedded in HTML using either the object or embed element,[33] although support for these elements by Web browsers is inconsistent.[34] However, the applet tag is deprecated, so the object tag is preferred where supported.

The host application, typically a Web browser, instantiates the Hello applet and creates an AppletContext for the applet. Once the applet has initialized itself, it is added to the AWT display hierarchy. The paintComponent() method is called by the AWT event dispatching thread whenever the display needs the applet to draw itself.

[edit]Servlet

Java Servlet technology provides Web developers with a simple, consistent mechanism for extending the functionality of a Web server and for accessing existing business systems. Servlets are server-side Java EE components that generate responses (typically HTML pages) to requests (typically HTTP requests) from clients. A servlet can almost be thought of as an applet that runs on the server side—without a face.

// Hello.java import java.io.*; import javax.servlet.*;   public class Hello extends GenericServlet {     public void service(ServletRequest request, ServletResponse response)              throws ServletException, IOException {        response.setContentType("text/html");        final PrintWriter pw = response.getWriter();        pw.println("Hello, world!");        pw.close();    } } 

The import statements direct the Java compiler to include all of the public classes and interfaces from the java.io and javax.servlet packages in the compilation.

The Hello class extends the GenericServlet class; the GenericServlet class provides the interface for the server to forward requests to the servlet and control the servlet's lifecycle.

The Hello class overrides the service(ServletRequest, ServletResponse) method defined by the Servlet interface to provide the code for the service request handler. The service() method is passed a ServletRequest object that contains the request from the client and a ServletResponse object used to create the response returned to the client. The service() method declares that it throws the exceptions ServletException and IOException if a problem prevents it from responding to the request.

The setContentType(String) method in the response object is called to set the MIME content type of the returned data to "text/html". The getWriter() method in the response returns a PrintWriter object that is used to write the data that is sent to the client. The println(String) method is called to write the "Hello, world!" string to the response and then the close() method is called to close the print writer, which causes the data that has been written to the stream to be returned to the client.

[edit]JavaServer Page

JavaServer Pages (JSPs) are server-side Java EE components that generate responses, typically HTML pages, to HTTP requests from clients. JSPs embed Java code in an HTML page by using the special delimiters . A JSP is compiled to a Java servlet, a Java application in its own right, the first time it is accessed. After that, the generated servlet creates the response.

[edit]Swing application

Swing is a graphical user interface library for the Java SE platform. It is possible to specify a different look and feel through the pluggable look and feel system of Swing. Clones ofWindows, GTK+ and Motif are supplied by Sun. Apple also provides an Aqua look and feel for Mac OS X. Where prior implementations of these looks and feels may have been considered lacking, Swing in Java SE 6 addresses this problem by using more native GUI widget drawing routines of the underlying platforms.

This example Swing application creates a single window with "Hello, world!" inside:

// Hello.java (Java SE 5) import javax.swing.*;   public class Hello extends JFrame {     public Hello() {         setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);         add(new JLabel("Hello, world!"));         pack();     }       public static void main(String[] args) {         new Hello().setVisible(true);     } } 

The first import includes all of the public classes and interfaces from the javax.swing package.

The Hello class extends the JFrame class; the JFrame class implements a window with a title bar and a close control.

The Hello() constructor initializes the frame by first calling the superclass constructor, passing the parameter "hello", which is used as the window's title. It then calls thesetDefaultCloseOperation(int) method inherited from JFrame to set the default operation when the close control on the title bar is selected toWindowConstants.EXIT_ON_CLOSE — this causes the JFrame to be disposed of when the frame is closed (as opposed to merely hidden), which allows the JVM to exit and the program to terminate. Next, the layout of the frame is set to a BorderLayout; this tells Swing how to arrange the components that will be added to the frame. A JLabel is created for the string "Hello, world!" and the add(Component) method inherited from the Container superclass is called to add the label to the frame. The pack() method inherited from the Window superclass is called to size the window and lay out its contents.

The main() method is called by the JVM when the program starts. It instantiates a new Hello frame and causes it to be displayed by calling the setVisible(boolean) method inherited from the Component superclass with the boolean parameter true. Once the frame is displayed, exiting the main method does not cause the program to terminate because the AWT event dispatching thread remains active until all of the Swing top-level windows have been disposed.

[edit]Generics

In 2004 generics were added to the Java language, as part of J2SE 5.0. Prior to the introduction of generics, each variable declaration had to be of a specific type. For container classes, for example, this is a problem because there is no easy way to create a container that accepts only specific types of objects. Either the container operates on all subtypes of a class or interface, usually Object, or a different container class has to be created for each contained class. Generics allow compile-time type checking without having to create a large number of container classes, each containing almost identical code.

[edit]Class libraries

Java Platform and Class libraries diagram

[edit]Documentation

Javadoc is a comprehensive documentation system, created by Sun Microsystems, used by many Java developers. It provides developers with an organized system for documenting their code. Whereas normal comments in Java and C are set off with /* and */, the multi-line comment tags, Javadoc comments have an extra asterisk at the beginning, so that the tags are /** and */.

[edit]Examples

The following is an example of java code commented with simple Javadoc-style comments:

/**  * A program that does useful things.  */ public class Program {     /**    * A main method.    * @param args The arguments    */   public static void main(String[] args) {     //do stuff   } } 

[edit]Editions

Java editions
Wave.svg
Java Card
Micro Edition (ME)
Standard Edition (SE)
Enterprise Edition (EE)
PersonalJava (discontinued)

Sun has defined and supports four editions of Java targeting different application environments and segmented many of its APIs so that they belong to one of the platforms. The platforms are:

The classes in the Java APIs are organized into separate groups called packages. Each package contains a set of related interfaces, classes and exceptions. Refer to the separate platforms for a description of the packages available.

The set of APIs is controlled by Sun Microsystems in cooperation with others through the Java Community Process program. Companies or individuals participating in this process can influence the design and development of the APIs. This process has been a subject of controversy.

Sun also provided an edition called PersonalJava that has been superseded by later, standards-based Java ME configuration-profile pairings.

[edit]See also