Introduction to Java Programming - Chapter 16: Applets and Multimedia

Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 1 Chapter 16 Applets and Multimedia Chapter 12 GUI Basics Chapter 14 Event-Driven Programming Chapter 15 Creating User Interfaces §10.2, “Abstract Classes,” in Chapter 10 Chapter 13 Graphics Chapter 16 Applets and Multimedia §10.4, “Interfaces,” in Chapter 10 Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 2 Objectives  To explain how the Web browser controls and executes applets (§ 15.2).  To describe the init, start, stop, and destroy methods in the Applet class (§ 15.2).  To know how to embed applets in Web pages (§ 15.4).  To run applets from appletviewer and from Web browsers (§ 15.4).  To pass string values to applets from HTML (§ 15.5).  To write a Java program that can run as both an application and an applet (§ 15.6).  To get image files using the URL class and display images in the panel (§ 15.9 Optional).  To develop a reusable component ImageViewer to display images (§ 15.10 Optional).  To get audio files and play sound (§ 15.12 Optional).  To package and deploy Java projects using Java archive files (§ 15.13 Optional).  To use Swing pluggable look-and-feel (§ 15.14 Optional). Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 3 The JApplet Class The Applet class is an AWT class and is not designed to work with Swing components. To use Swing components in Java applets, it is necessary to create a Java applet that extends javax.swing.JApplet, which is a subclass of java.applet.Applet. JApplet inherits all the methods from the Applet class. In addition, it provides support for laying out Swing components. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 4 First Simple Applet // WelcomeApplet.java: Applet for displaying a message import javax.swing.*; public class WelcomeApplet extends JApplet { /** Initialize the applet */ public WelcomeApplet() { add(new JLabel("Welcome to Java", JLabel.CENTER)); } } // WelcomeApplet.java: Applet for displaying a message import javax.swing.*; public class WelcomeApplet extends JApplet { /** Initialize the applet */ public void init() { add(new JLabel("Welcome to Java", JLabel.CENTER)); } } Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 5 First Simple Applet Welcome Java Applet <applet code = "WelcomeApplet.class" width = 350 height = 200> WelcomeApplet Run Applet Viewer Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 6 Applet vs. Application import javax.swing.*; public class MyFrameWithlable{ public static void main(String[] args) { JFrame frame = new JFrame("MyFrameWithLable"); frame.add(new JLabel("Welcome to Java", JLabel.CENTER)); frame.setSize(400, 300); frame.setVisible(true); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setLocationRelativeTo(null); // New since JDK 1.4 } } // WelcomeApplet.java: Applet for displaying a message import javax.swing.*; public class WelcomeApplet extends JApplet { /** Initialize the applet */ public void init() { add(new JLabel("Welcome to Java", JLabel.CENTER)); } } Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 7 The Applet Class, cont. Applets are created, run, and destroyed by web browser – Don’t set size for an applet: determined by HTML file. – Don’t set title for an applet: applets cannot have title bars.  Can have menus. – No need to explicitly construct an applet. Construction code placed inside the init method. – There is no main method. – An applet cannot be closed. It terminates automatically when the browser exit. – No need to call method show. An applet is displayed automatically. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 8 The Applet Class, cont. When the applet is loaded, the Web browser creates an instance of the applet by invoking the applet’s no-arg constructor. The browser uses the init, start, stop, and destroy methods to control the applet. By default, these methods do nothing. To perform specific functions, they need to be modified in the user's applet so that the browser can call your code properly. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 9 The Applet Class public class MyApplet extends java.applet.Applet { ... /** The no-arg constructor is called by the browser when the Web page containing this applet is initially loaded, or reloaded */ public MyApplet() { ... } /** Called by the browser after the applet is loaded */ public void init() { ... } /** Called by the browser after the init() method, or every time the Web page is visited */ public void start() { ... } /** Called by the browser when the page containing this applet becomes inactive */ public void stop() { ... } /** Called by the browser when the Web browser exits */ public void destroy() { ... } /** Other methods if necessary... */ } Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 10 Browser Calling Applet Methods Browser invokes start() Destroyed Browser invokes destroy() Browser invokes stop() Loaded Initialized Browser invokes init() Started Stopped Created Browser creates the applet JVM loads the applet class Browser invokes stop() Browser invokes start() Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 11 The init() Method Invoked when the applet is first loaded and again if the applet is reloaded. A subclass of Applet should override this method if the subclass has an initialization to perform. The functions usually implemented in this method include creating new threads, loading images, setting up user-interface components, and getting string parameter values from the tag in the HTML page. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 12 The start() Method Invoked after the init() method is executed; also called whenever the applet becomes active again after a period of inactivity (for example, when the user returns to the page containing the applet after surfing other Web pages). A subclass of Applet overrides this method if it has any operation that needs to be performed whenever the Web page containing the applet is visited. An applet with animation, for example, might use the start method to resume animation. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 13 The stop() Method The opposite of the start() method, which is called when the user moves back to the page containing the applet; the stop() method is invoked when the user moves off the page. A subclass of Applet overrides this method if it has any operation that needs to be performed each time the Web page containing the applet is no longer visible. When the user leaves the page, any threads the applet has started but not completed will continue to run. You should override the stop method to suspend the running threads so that the applet does not take up system resources when it is inactive. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 14 The destroy() Method Invoked when the browser exits normally to inform the applet that it is no longer needed and that it should release any resources it has allocated. A subclass of Applet overrides this method if it has any operation that needs to be performed before it is destroyed. Usually, you won't need to override this method unless you wish to release specific resources, such as threads that the applet created. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 15 Example: Using Applets Objective: Compute Loans. The applet enables the user to enter the annual interest rate, the number of years, and the loan amount. Click the Compute Loan button, and the applet displays the monthly payment and the total payment. LoanApplet Run Applet Viewer Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 16 Writing Applets  Always extends the JApplet class, which is a subclass of Applet for Swing components.  Override init(), start(), stop(), and destroy() if necessary. By default, these methods are empty.  Add your own methods and data if necessary.  Applets are always embedded in an HTML page. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 17 The HTML Tag <applet code=classfilename.class width=applet_viewing_width_in_pixels height=applet_viewing_height_in_pixels [archive=archivefile] [codebase=applet_url] [vspace=vertical_margin] [hspace=horizontal_margin] [align=applet_alignment] [alt=alternative_text] > <param name=param_name1 value=param_value1> Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 18 Passing Parameters to Applets <applet code = "DisplayMessage.class" width = 200 height = 50> <param name=MESSAGE value="Welcome to Java"> alt="You must have a Java-enabled browser to view the applet" Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 19 Example: Passing Parameters to Java Applets Objective: Display a message at a specified location. The message and the location (x, y) are obtained from the HTML source. Run Applet Viewer DisplayMessage Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 20 Applications vs. Applets  Similarities – Since JFrame and JApplet both are subclasses of the Container class, all the user interface components, layout managers, and event-handling features are the same for both classes.  Differences – Applications are invoked from the static main method by the Java interpreter, and applets are run by the Web browser. The Web browser creates an instance of the applet using the applet’s no-arg constructor and controls and executes the applet through the init, start, stop, and destroy methods. – Applets have security restrictions Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 21 Security Restrictions on Applets  Applets are not allowed to read from, or write to, the file system of the computer viewing the applets.  Applets are not allowed to run any programs on the browser’s computer.  Applets are not allowed to establish connections between the user’s computer and another computer except with the server where the applets are stored. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 22 Conversions Between Applications and Applets  Conversions between applications and applets are simple and easy.  You can always convert an applet into an application.  You can convert an application to an applet as long as security restrictions are not violated. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 23 Example: Running a Program as an Applet and as an Application  Objective: Modify MessageApplet to enable it to run both as an applet and as an application. Run as Application Run as Applet DisplayMessageApp Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 24 Case Study: TicTacToe Cell -token: char +getToken():char +setToken(token: char): void #paintComponent(g: Graphics): void +mouseClicked(e: MouseEvent): void JPanel Token used in the cell (default: ' '). Returns the token in the cell. Sets a new token in the cell. Paints the token in the cell. Handles a mouse click on the cell. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 25 Case Study: TicTacToe, cont. Run as Applet TicTacToe Run as Application 1 9 TicTacToe -whoseTurn: char -cell: Cell[][] -jlblStatus: JLabel +TicTacToe() +isFull(): boolean +isWon(token: char): boolean JApplet Cell Indicates which player has the turn, initially 'X'. A 3 by 3, two dimensional array for cells. A label to display game status. Constructs the TicTacToe user interface. Returns true if all cells are filled. Returns true if a player with the specified token has won. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 26 Objective: Write an applet that displays a ball bouncing in a panel. Use two buttons to suspend and resume the movement and use a scroll bar to control the bouncing speed. Optional Case Study: Bouncing Ball Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 27 Case Study: Bouncing Ball, cont. Ball BallControl BounceBallApp Run BounceBallApp +BounceBallApp() +main(args: String[]): void JApplet BallControl -ball: Ball -jsbDelay: JScrollBar -jbtResume: JButton -jbtSuspend: JButton +BallControl() JPanel Ball -x: int -y: int -dx: int -dy: int -radius: int -delay: int -timer: Timer +Ball() +suspend(): void +resume(): void +setDelay(delay: int): void JPanel 1 1 1 1 Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 28 Locating Resource from Applets Due to security restrictions, applets cannot access local files. How can an applet load resource files for image and audio? Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 29 You used the ImageIcon class to create an icon from an image file and the setIcon method or the constructor to place the image in a GUI component, such as a button and a label. For example, the following statements create an ImageIcon and set it on an JLabel object jlbl. ImageIcon imageIcon = new ImageIcon("c:\\book\\image\\us.gif"); jlbl.setIcon(imageIcon); This approach suffers a problem. The file location is fixed since it uses the absolute file path on Window. Thus, the program cannot run on other platforms and cannot run as applet. Creating ImageIcon Using Absolute File Names Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 30 Assume that image/us.gif is under the class directory, you can circumvent this problem by using a relative path as follows: ImageIcon imageIcon = new ImageIcon("image/us.gif"); jlbl.setIcon(imageIcon); This works fine with Java applications on all platforms, but does not work with Java applets because applets cannot load local files. To make it to work with both applications and applets, you need to locate the file using the URL class. Creating ImageIcon Using Relative File Names Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 31 Locating Resource Using the URL Class The java.net.URL class can be used to identify files (image, audio, text, etc.) on the Internet. In general, a URL (Uniform Resource Locator) is a pointer to a “resource” on the World Wide Web on a local machine or a remote host. A resource can be something as simple as a file or a directory. An URL for a file can also be accessed by class code in a way that is independent of the location of the file as long as the file is located in the class directory. Recall that the class directory is where the class (i.e., the .class file) is stored. For example, all the classes in this book are stored in c:\book. So the class directory is c:\book. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 32 Creating a URL from a Class Reference As discussed in §9.11.5, “The getClass Method,” when a class is loaded, the JVM creates a meta-object for the class, which can be obtained using java.lang.Class metaObject = this.getClass(); The Class class provides access to useful information about the class, such as the data fields, constructors, and methods. It also contains the getResource(filename) method, which can be used to obtain the URL of a given file name in the class directory. To obtain the URL of a file in the class directory, use URL url = metaObject.getResource(filename); For example, suppose the class directory is c:\book, the following statements create a URL for c:\book\image\us.gif. Class metaObject = this.getClass(); URL url = metaObject.getResource("image/us.gif"); You can now create an ImageIcon using ImageIcon imageIcon = new ImageIcon(url); Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 33 Displaying Image Write a program that displays an image from /image/us.gif in the class directory on a panel. DisplayImageWithURL Run Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 34 Creating AudioClip from an Audio File To play an audio file in an applet, first create an audio clip object for the audio file. The audio clip is created once and can be played repeatedly without reloading the file. To create an audio clip, use the static method newAudioClip() in the java.applet.Applet class: AudioClip audioClip = Applet.newAudioClip(url); Audio was originally used with Java applets. For this reason, the AudioClip interface is in the java.applet package. The following statements, for example, create an AudioClip for the beep.au audio file in the same directory with the class you are running. Class class = this.getClass(); URL url = class.getResource("beep.au"); AudioClip audioClip = Applet.newAudioClip(url); Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 35 Playing Audio To manipulate a sound for an audio clip, use the play(), loop(), and stop() methods in java.applet.AudioClip. DisplayImagePlayAudio Run «interface» java.applet.AudioClip +play() +loop() +stop() Starts playing this audio clip. Each time this method is called, the clip is restarted from the beginning. Plays the clip repeatedly. Stops playing the clip. Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 36 Multimedia Animation ImageAudioAnimation Run as an Application Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 37 Packaging and Deploying Java Projects What is JAR? Java archive file can be used to group all the project files in a compressed file for deployment. The Java archive file format (JAR) is based on the popular ZIP file format. This single file can be deployed on an end-user’s machine as an application. It also can be downloaded to a browser in a single HTTP transaction, rather than opening a new connection for each piece. This greatly simplifies application deployment and improves the speed with which an applet can be loaded onto a web page and begin functioning. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 38 Creating JAR You can use the JDK jar command to create an archive file. The following command creates an archive file named TicTacToe.jar for classes TicTacToe.class and TicTacToe$Cell.class. jar -cf TicTacToe.jar TicTacToe.class TicTacToe$Cell.class The -c option is for creating a new archive file, and the -f option specifies the archive file’s name. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 39 Viewing the Contents of a JAR File You can view the contents of a .jar file using WinZip. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 40 Manifest File A manifest file was created with the path name meta-inf\. The manifest is a special file that contains information about the files packaged in a JAR file. For instance, the manifest file in TicTacToe.jar contains the following information: Manifest-Version: 1.0 Name: TicTacToe.class Java-Bean: True Name: TioTacToe$Cell.class Java-Bean: True You can modify the information contained in the manifest file to enable the JAR file to be used for a variety of purposes. For instance, you can add information to specify a main class to run an application using the .jar file. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 41 Running Archived Projects Standalone The manifest file must have an entry to contain the main class. For example, to run TicTacToe, you need to insert the following two lines in the manifest file: Main-Class: TicTacToe Sealed: true Run the .jar file using the java command from the directory that contains TicTacToe.jar, java -jar TicTacToe.jar TIP: You can write an installation procedure that creates the necessary directories and subdirectories on the end-user’s computer. The installation can also create an icon that the end-user can double- click on to start the program. For information on creating Windows desktop icon, please see www.prenhall.com/liang/intro5e.html. Optional Liang, Introduction to Java Programming, Sixth Edition, (c) 2005 Pearson Education, Inc. All rights reserved. 0-13-148952-6 42 Running Archived Projects As Applet To run TicTacToe as an applet, modify the tag in the HTML file to include an ARCHIVE attribute. The ARCHIVE attribute specifies the archive file in which the applet is contained. For example, the HTML file for running TicTacToe can be modified as shown below: <APPLET CODE = "TicTacToe.class" ARCHIVE = "TicTacToe.jar" WIDTH = 400 HEIGHT = 300 HSPACE = 0 VSPACE = 0 ALIGN = Middle > Optional