Java network programming th

This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > • • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Java Network Programming, 3rd Edition By Elliotte Rusty Harold Publisher: O'Reilly Pub Date: October 2004 ISBN: 0-596-00721-3 Pages: 706 Thoroughly revised to cover all the 100+ significant updates to Java Developers Kit (JDK) 1.5, Java Network Programming is a complete introduction to developing network programs (both applets and applications) using Java, covering everything from networking fundamentals to remote method invocation (RMI) It includes chapters on TCP and UDP sockets, multicasting protocol and content handlers, servlets, and the new I/O API This is the essential resource for any serious Java developer < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > • • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Java Network Programming, 3rd Edition By Elliotte Rusty Harold Publisher: O'Reilly Pub Date: October 2004 ISBN: 0-596-00721-3 Pages: 706 Copyright Preface About the Third Edition Organization of the Book Who You Are Java Versions About the Examples Conventions Used in This Book Request for Comments Comments and Questions Acknowledgments Chapter Why Networked Java? Section 1.1 What Can a Network Program Do? Section 1.2 Security Section 1.3 But Wait! There's More! Chapter Basic Network Concepts Section 2.1 Networks Section 2.2 The Layers of a Network Section 2.3 IP, TCP, and UDP Section 2.4 The Internet Section 2.5 The Client/Server Model Section 2.6 Internet Standards Chapter Basic Web Concepts Section 3.1 URIs Section 3.2 HTML, SGML, and XML Section 3.3 HTTP Section 3.4 MIME Media Types This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Section 3.5 Server-Side Programs Chapter Streams Section 4.1 Output Streams Section 4.2 Input Streams Section 4.3 Filter Streams Section 4.4 Readers and Writers Chapter Threads Section 5.1 Running Threads Section 5.2 Returning Information from a Thread Section 5.3 Synchronization Section 5.4 Deadlock Section 5.5 Thread Scheduling Section 5.6 Thread Pools Chapter Looking Up Internet Addresses Section 6.1 The InetAddress Class Section 6.2 Inet4Address and Inet6Address Section 6.3 The NetworkInterface Class Section 6.4 Some Useful Programs Chapter URLs and URIs Section 7.1 The URL Class Section 7.2 The URLEncoder and URLDecoder Classes Section 7.3 The URI Class Section 7.4 Proxies Section 7.5 Communicating with Server-Side Programs Through GET Section 7.6 Accessing Password-Protected Sites Chapter HTML in Swing Section 8.1 HTML on Components Section 8.2 JEditorPane Section 8.3 Parsing HTML Section 8.4 Cookies Chapter Sockets for Clients Section 9.1 Socket Basics Section 9.2 Investigating Protocols with Telnet Section 9.3 The Socket Class Section 9.4 Socket Exceptions Section 9.5 Socket Addresses Section 9.6 Examples Chapter 10 Sockets for Servers Section 10.1 The ServerSocket Class Section 10.2 Some Useful Servers Chapter 11 Secure Sockets Section 11.1 Secure Communications Section 11.2 Creating Secure Client Sockets Section 11.3 Methods of the SSLSocket Class Section 11.4 Creating Secure Server Sockets Section 11.5 Methods of the SSLServerSocket Class Chapter 12 Non-Blocking I/O Section 12.1 An Example Client Section 12.2 An Example Server Section 12.3 Buffers Section 12.4 Channels Section 12.5 Readiness Selection Chapter 13 UDP Datagrams and Sockets This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Chapter 13 UDP Datagrams and Sockets Section 13.1 The UDP Protocol Section 13.2 The DatagramPacket Class Section 13.3 The DatagramSocket Class Section 13.4 Some Useful Applications Section 13.5 DatagramChannel Chapter 14 Multicast Sockets Section 14.1 What Is a Multicast Socket? Section 14.2 Working with Multicast Sockets Section 14.3 Two Simple Examples Chapter 15 URLConnections Section 15.1 Opening URLConnections Section 15.2 Reading Data from a Server Section 15.3 Reading the Header Section 15.4 Configuring the Connection Section 15.5 Configuring the Client Request HTTP Header Section 15.6 Writing Data to a Server Section 15.7 Content Handlers Section 15.8 The Object Methods Section 15.9 Security Considerations for URLConnections Section 15.10 Guessing MIME Content Types Section 15.11 HttpURLConnection Section 15.12 Caches Section 15.13 JarURLConnection Chapter 16 Protocol Handlers Section 16.1 What Is a Protocol Handler? Section 16.2 The URLStreamHandler Class Section 16.3 Writing a Protocol Handler Section 16.4 More Protocol Handler Examples and Techniques Section 16.5 The URLStreamHandlerFactory Interface Chapter 17 Content Handlers Section 17.1 What Is a Content Handler? Section 17.2 The ContentHandler Class Section 17.3 The ContentHandlerFactory Interface Section 17.4 A Content Handler for the FITS Image Format Chapter 18 Remote Method Invocation Section 18.1 What Is Remote Method Invocation? Section 18.2 Implementation Section 18.3 Loading Classes at Runtime Section 18.4 The java.rmi Package Section 18.5 The java.rmi.registry Package Section 18.6 The java.rmi.server Package Chapter 19 The JavaMail API Section 19.1 What Is the JavaMail API? Section 19.2 Sending Email Section 19.3 Receiving Mail Section 19.4 Password Authentication Section 19.5 Addresses Section 19.6 The URLName Class Section 19.7 The Message Class Section 19.8 The Part Interface Section 19.9 Multipart Messages and File Attachments Section 19.10 MIME Messages This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Section 19.11 Folders Colophon Index < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Copyright © 2005, 2000, 1997 O'Reilly Media, Inc All rights reserved Printed in the United States of America Published by O'Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, CA 95472 O'Reilly books may be purchased for educational, business, or sales promotional use Online editions are also available for most titles (http://safari.oreilly.com) For more information, contact our corporate/institutional sales department: (800) 998-9938 or corporate@oreilly.com Nutshell Handbook, the Nutshell Handbook logo, and the O'Reilly logo are registered trademarks of O'Reilly Media, Inc Java™ Network Programming, Third Edition, the image of a river otter, and related trade dress are trademarks of O'Reilly Media, Inc Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries O'Reilly Media, Inc is independent of Sun Microsystems Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks Where those designations appear in this book, and O'Reilly Media, Inc was aware of a trademark claim, the designations have been printed in caps or initial caps While every precaution has been taken in the preparation of this book, the publisher and author assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Preface Java's growth over the last 10 years has been nothing short of phenomenal Given Java's rapid rise to prominence and the even more spectacular growth of the Internet, it's a little surprising that network programming in Java is still so mysterious to so many It doesn't have to be In fact, writing network programs in Java is quite simple, as this book will show Readers with previous experience in network programming in a Unix, Windows, or Macintosh environment should be pleasantly surprised at how much easier it is to write equivalent programs in Java The Java core API includes welldesigned interfaces to most network features Indeed, there is very little application-layer network software you can write in C or C++ that you can't write more easily in Java Java Network Programming, 3rd Edition endeavors to show you how to take advantage of Java's network class library to quickly and easily write programs that accomplish many common networking tasks Some of these include: Browsing the Web with HTTP Parsing and rendering HTML Sending email with SMTP Receiving email with POP and IMAP Writing multithreaded servers Installing new protocol and content handlers into browsers Encrypting communications for confidentiality, authentication, and guaranteed message integrity Designing GUI clients for network services Posting data to server-side programs Looking up hosts using DNS Downloading files with anonymous FTP Connecting sockets for low-level network communication Distributing applications across multiple systems with Remote Method Invocation Java is the first language to provide such a powerful cross-platform network library, which handles all these diverse tasks Java Network Programming exposes the power and sophistication of this library This book's goal is to enable you to start using Java as a platform for serious network programming To so, this book provides a general background in network fundamentals, as well as detailed discussions of Java's facilities for writing network programs You'll learn how to write Java programs that share data across the Internet for games, collaboration, software updates, file transfer, and more You'll also get a behind-the-scenes look at HTTP, SMTP, TCP/IP, and the other protocols that support the Internet and the Web When you finish this book, you'll have the knowledge and the tools to create the next generation of software that takes full advantage of the Internet < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > About the Third Edition In 1996, in the first chapter of the first edition of this book, I wrote extensively about the sort of dynamic, distributed network applications I thought Java would make possible One of the most exciting parts of writing subsequent editions has been seeing virtually all of the applications I foretold come to pass Programmers are using Java to query database servers, monitor web pages, control telescopes, manage multiplayer games, and more, all by using Java's native ability to access the Internet Java in general and network programming in Java in particular has moved well beyond the hype stage and into the realm of real, working applications Not all network software is yet written in Java, but it's not for a lack of trying Efforts are well under way to subvert the existing infrastructure of C-based network clients and servers with pure Java replacements Clients for newer protocols like Gnutella and Freenet are preferentially written in Java It's unlikely that Java will replace C for all network programming in the near future However, the mere fact that many people are willing to use web browsers, web servers, and more written in Java shows just how far we've come since 1996 This book has come a long way, too The third edition has one completely new chapter to describe the most significant development in network programming since readers and writers were introduced in Java 1.1 I refer of course to the new I/O APIs in the java.nio package The ability to perform asynchronous, non-blocking I/O operations is critical for high-performance network applications, especially servers It removes one of the last barriers to using Java for network servers Many other chapters have been updated to take advantage of these new I/O APIs There've been lots of other small changes and updates throughout the java.net and supporting packages in Java 1.4 and 1.5, and these are covered here as well New classes addressed in this edition include CookieHandler, SocketAddress, Proxy, NetworkInterface, and URI IPv6 has become a reality, and is now covered extensively Many other methods have been added to existing classes in the last two releases of Java, and these are discussed in the relevant chapters I've also rewritten large parts of the book to reflect changing fashions in Java programming in general and network programming in particular Applets and CGI programs are emphasized much less In their place, you'll find more generic discussion of remote code execution and server-side environments, however implemented Of course, the text has been cleaned up, too There's only one completely new chapter here, but the 18 existing chapters have been extensively rewritten and expanded to bring them up-to-date with new developments as well as to make them clearer and more engaging I hope you'll find this third edition an even stronger, longer-lived, more accurate, and more enjoyable tutorial and reference to network programming in Java than the last edition < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Organization of the Book This book begins with three chapters that outline how networks and network programs work Chapter 1, is a gentle introduction to network programming in Java and the applications it makes possible All readers should find something of interest in this chapter It explores some of the unique programs that become feasible when networking is combined with Java Chapter 2, and Chapter 3, explain in detail what a programmer needs to know about how the Internet and the Web work Chapter describes the protocols that underlie the Internet, such as TCP/IP and UDP/IP Chapter describes the standards that underlie the Web, such as HTTP, HTML, and REST If you've done a lot of network programming in other languages on other platforms, you may be able to skip these two chapters The next two chapters throw some light on two parts of Java programming that are critical to almost all network programs but are often misunderstood and misused, I/O and threading Chapter 4, explores Java's classic I/O models which, despite the new I/O APIs, aren't going away any time soon and are still the preferred means of handling input and output in most client applications Understanding how Java handles I/O in the general case is a prerequisite for understanding the special case of how Java handles network I/O Chapter 5, explores multithreading and synchronization, with a special emphasis on how they can be used for asynchronous I/O and network servers Experienced Java programmers may be able to skim or skip these two chapters However, Chapter 6, is essential reading for everyone It shows how Java programs interact with the domain name system through the InetAddress class, the one class that's needed by essentially all network programs Once you've finished this chapter, it's possible to jump around in the book as your interests and needs dictate There are, however, some interdependencies between specific chapters Figure P-1 should allow you to map out possible paths through the book Figure P-1 Chapter prerequisites Chapter 7, URLs and URIs, explores Java's URL class, a powerful abstraction for downloading information and files from network servers of many kinds The URL class enables you to connect to and download files and documents from a network server without concerning yourself with the details of the protocol the server speaks It lets you connect to an FTP server using the same code you use to talk to an HTTP server or to read a file on the local hard disk This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com FTP server using the same code you use to talk to an HTTP server or to read a file on the local hard disk Once you've got an HTML file from a server, you're going to want to something with it Parsing and rendering HTML is one of the most difficult challenges network programmers can face Chapter 8, introduces some little known classes for parsing and rendering HTML documents that take this burden off your shoulders and put it on Sun's Chapter through Chapter 11 discuss Java's low-level socket classes for network access Chapter 9, introduces the Java sockets API and the Socket class in particular It shows you how to write network clients that interact with TCP servers of all kinds including whois, finger, and HTTP Chapter 10, shows you how to use the ServerSocket class to write servers for these and other protocols in Java Chapter 11, shows you how to protect your client server communications using the Secure Sockets Layer (SSL) and the Java Secure Sockets Extension (JSSE) Chapter 12, covers the new I/O APIs introduced in Java 1.4 These APIs were specifically designed for network servers They enable a program to figure out whether a connection is ready before it tries to read from or write to the socket This allows a single thread to manage many different connections simultaneously, thereby placing much less load on the virtual machine The new I/O APIs don't help much for small servers or clients that don't open many simultaneous connections, but they provide huge performance boosts for high volume servers that want to transmit as much data as the network can handle as fast as the network can deliver it Chapter 13, introduces the User Datagram Protocol (UDP) and the associated DatagramPacket and DatagramSocket classes that provide fast, unreliable communication Finally, Chapter 14, shows you how to use UDP to communicate with multiple hosts at the same time All the other classes that access the network from Java rely on the classes described in these five chapters Chapter 15 through Chapter 17 look more deeply at the infrastructure supporting the URL class These chapters introduce protocol and content handlers, concepts unique to Java that make it possible to write dynamically extensible software that automatically understands new protocols and media types Chapter 15, describes the class that serves as the engine for the URL class of Chapter It shows you how to take advantage of this class through its public API Chapter 16, also focuses on the URLConnection class but from a different direction; it shows you how to subclass this class to create handlers for new protocols and URLs Finally, Chapter 17, explores Java's somewhat moribund mechanism for supporting new media types Chapter 18 and Chapter 19 introduce two unique higher-level APIs for network programs, Remote Method Invocation (RMI) and the JavaMail API Chapter 18, introduces this powerful mechanism for writing distributed Java applications that run across multiple heterogeneous systems at the same time while communicating with straightforward method calls just like a nondistributed program Chapter 19, acquaints you with this standard extension to Java, which offers an alternative to low-level sockets for talking to SMTP, POP, IMAP, and other email servers Both of these APIs provide distributed applications with less cumbersome alternatives to lower-level protocols < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com FTP server using the same code you use to talk to an HTTP server or to read a file on the local hard disk Once you've got an HTML file from a server, you're going to want to something with it Parsing and rendering HTML is one of the most difficult challenges network programmers can face Chapter 8, introduces some little known classes for parsing and rendering HTML documents that take this burden off your shoulders and put it on Sun's Chapter through Chapter 11 discuss Java's low-level socket classes for network access Chapter 9, introduces the Java sockets API and the Socket class in particular It shows you how to write network clients that interact with TCP servers of all kinds including whois, finger, and HTTP Chapter 10, shows you how to use the ServerSocket class to write servers for these and other protocols in Java Chapter 11, shows you how to protect your client server communications using the Secure Sockets Layer (SSL) and the Java Secure Sockets Extension (JSSE) Chapter 12, covers the new I/O APIs introduced in Java 1.4 These APIs were specifically designed for network servers They enable a program to figure out whether a connection is ready before it tries to read from or write to the socket This allows a single thread to manage many different connections simultaneously, thereby placing much less load on the virtual machine The new I/O APIs don't help much for small servers or clients that don't open many simultaneous connections, but they provide huge performance boosts for high volume servers that want to transmit as much data as the network can handle as fast as the network can deliver it Chapter 13, introduces the User Datagram Protocol (UDP) and the associated DatagramPacket and DatagramSocket classes that provide fast, unreliable communication Finally, Chapter 14, shows you how to use UDP to communicate with multiple hosts at the same time All the other classes that access the network from Java rely on the classes described in these five chapters Chapter 15 through Chapter 17 look more deeply at the infrastructure supporting the URL class These chapters introduce protocol and content handlers, concepts unique to Java that make it possible to write dynamically extensible software that automatically understands new protocols and media types Chapter 15, describes the class that serves as the engine for the URL class of Chapter It shows you how to take advantage of this class through its public API Chapter 16, also focuses on the URLConnection class but from a different direction; it shows you how to subclass this class to create handlers for new protocols and URLs Finally, Chapter 17, explores Java's somewhat moribund mechanism for supporting new media types Chapter 18 and Chapter 19 introduce two unique higher-level APIs for network programs, Remote Method Invocation (RMI) and the JavaMail API Chapter 18, introduces this powerful mechanism for writing distributed Java applications that run across multiple heterogeneous systems at the same time while communicating with straightforward method calls just like a nondistributed program Chapter 19, acquaints you with this standard extension to Java, which offers an alternative to low-level sockets for talking to SMTP, POP, IMAP, and other email servers Both of these APIs provide distributed applications with less cumbersome alternatives to lower-level protocols < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Who You Are This book assumes you are comfortable with the Java language and programming environment, in addition to objectoriented programming in general This book does not attempt to be a basic language tutorial You should be thoroughly familiar with the syntax of Java You should have written simple applications and applets You should also be comfortable with basic AWT and Swing programming When you encounter a topic that requires a deeper understanding for network programming than is customary—for instance, threads and streams—I'll cover that topic as well, at least briefly You should also be an accomplished user of the Internet I will assume you know how to FTP files and visit web sites You should know what a URL is and how you locate one You should know how to write simple HTML and be able to publish a home page that includes Java applets, although you not need to be a super web designer However, this book doesn't assume that you have prior experience with network programming You should find it a complete introduction to networking concepts and network application development I don't assume that you have a few thousand networking acronyms (TCP, UDP, SMTP, etc.) at the tip of your tongue You'll learn what you need to know about these here It's certainly possible that you could use this book as a general introduction to network programming with a socket-like interface, and then go on to learn WSA (the Windows Socket Architecture) and figure out how to write network applications in C++ But it's not clear why you would want to: as I said earlier, Java lets you write very sophisticated applications with ease < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Java Versions Java's network classes have changed a lot more slowly since Java 1.0 than other parts of the core API In comparison to the AWT or I/O, there have been almost no changes and only a few additions Of course, all network programs make extensive use of the I/O classes and many make heavy use of GUIs This book is written with the assumption that you and your customers are using at least Java 1.1 In general, I use Java 1.1 features like readers and writers and the new event model freely without further explanation Java is a bit more of a stretch Although I wrote almost this entire book using Java 2, and although Java has been available for most platforms for several years, no Java runtime or development environment is yet available for MacOS It is virtually certain that neither Apple nor Sun will ever port any version of Java to MacOS 9.x or earlier, thus effectively locking out 60% of the current Mac-installed base from future developments This is not a good thing for a language that claims to be "write once, run anywhere." Furthermore, Microsoft's Java virtual machine supports Java 1.1 only and does not seem likely to improve in this respect for the foreseeable future Thus, while I have not shied away from using Java 2-specific features where they seemed useful or convenient—for instance, the ASCII encoding for the InputStreamReader and the keytool program—I have been careful to point out my use of such features Where 1.1 safe alternatives exist, they are noted When a particular method or class is new in Java 1.2 or later, it is noted by a comment following its declaration like this: public void setTimeToLive(int ttl) throws IOException // Java 1.2 To further muddy the waters, there are multiple versions of Java At the time this book was completed, the current release was the "Java™ SDK, Standard Edition, v 1.4.2_05" At least that's what it was called then Sun seems to change names at the drop of a marketing consultant In previous incarnations, this is what was simply known as the JDK Sun also makes available the "Java™ Platform, Enterprise Edition (J2EE©)" and "Java™ Platform, Micro Edition (J2ME©)" The Enterprise Edition is a superset of the standard edition that adds features like the Java Naming and Directory Interface and the JavaMail API that provide high-level APIs for distributed applications Most of these additional APIs are also available as extensions to the standard edition, and will be so treated here The Micro Edition is a subset of the standard edition targeted at cell phones, set-top boxes, and other memory, CPU, and display-challenged devices It removes a lot of the GUI APIs programmers have learned to associate with Java, although surprisingly it retains many of the basic networking and I/O classes discussed in this book Finally, when this book was about half complete, Sun released a beta of the "Java™ SDK, Standard Edition, v1.5" This added a few pieces to the networking API, but left most of the existing API untouched Over the next few months Sun released several more betas of JDK 1.5 The finishing touches were placed on this book and all the code tested with JDK 1.5 beta You shouldn't have any trouble using this book after 1.5 is released With any luck at all, discrepancies between the final specification and what I discuss here will be quite minor To be honest, the most annoying problem with all these different versions and editions was not the rewriting they necessitated It was figuring out how to identify them in the text I simply refuse to write Java™ SDK, Standard Edition, v1.3 or even Java 1.3 every time I want to point out a new feature in the latest release of Java I normally simply refer to Java 1.1, Java 1.2, Java 1.3, Java 1.4, and Java 1.5 Overall, though, the networking API seems fairly stable Java 1.1 through Java 1.3 are very similar, and there are a few only major additions in Java 1.4 and 1.5 Very little of the post-1.0 networking API has been deprecated < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > About the Examples Most methods and classes described in this book are illustrated with at least one complete working program, simple though it may be In my experience, a complete working program is essential to showing the proper use of a method Without a program, it is too easy to drop into jargon or to gloss over points about which the author may be unclear in his own mind The Java API documentation itself often suffers from excessively terse descriptions of the method calls In this book, I have tried to err on the side of providing too much explication rather than too little If a point is obvious to you, feel free to skip over it You not need to type in and run every example in this book, but if a particular method does give you trouble, you are guaranteed to have at least one working example Each chapter includes at least one (and often several) more complex programs that demonstrate the classes and methods of that chapter in a more realistic setting These often rely on Java features not discussed in this book Indeed, in many of the programs, the networking components are only a small fraction of the source code and often the least difficult parts Nonetheless, none of these programs could be written as easily in languages that didn't give networking the central position it occupies in Java The apparent simplicity of the networked sections of the code reflects the extent to which networking has been made a core feature of Java, and not any triviality of the program itself All example programs presented in this book are available online, often with corrections and additions You can download the source code from http://www.cafeaulait.org/books/jnp3/ This book assumes you are using Sun's Java Development Kit I have tested all the examples on Linux and many on Windows and MacOS X Almost all the examples given here should work on other platforms and with other compilers and virtual machines that support Java 1.2 (and most on Java 1.1, as well) The occasional examples that require Java 1.3, 1.4, or 1.5 are clearly noted < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Conventions Used in This Book Body text is Times Roman, normal, like you're reading now A monospaced typewriter font is used for: Code examples and fragments Anything that might appear in a Java program, including keywords, operators, data types, method names, variable names, class names, and interface names Program output Tags that might appear in an HTML document A bold monospaced font is used for: Command lines and options that should be typed verbatim on the screen An italicized font is used for: New terms where they are defined Pathnames, filenames, and program names (however, if the program name is also the name of a Java class, it is given in a monospaced font, like other class names) Host and domain names (java.oreilly.com) URLs (http://www.cafeaulait.org/slides/) Titles of other chapters and books (JavaI/O) Significant code fragments and complete programs are generally placed into a separate paragraph, like this: Socket s = new Socket("java.oreilly.com", 80); if (!s.getTcpNoDelay( )) s.setTcpNoDelay(true); When code is presented as fragments rather than complete programs, the existence of the appropriate import statements should be inferred For example, in the above code fragment you may assume that java.net.Socket was imported Some examples intermix user input with program output In these cases, the user input will be displayed in bold, as in this example from Chapter 9: % telnet rama.poly.edu Trying 128.238.10.212 Connected to rama.poly.edu Escape character is '^]' This is a test This is a test This is another test This is another test 9876543210 This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com 9876543210 9876543210 ^] telnet> close Connection closed The Java programming language is case-sensitive Java.net.socket is not the same as java.net.Socket Case-sensitive programming languages not always allow authors to adhere to standard English grammar Most of the time, it's possible to rewrite the sentence in such a way that the two not conflict, and when possible I have endeavored to so However, on those rare occasions when there is simply no way around the problem, I have let standard English come up the loser In keeping with this principle, when I want to refer to a class or an instance of a class in body text, I use the capitalization that you'd see in source code, generally an initial capital with internal capitalization—for example, ServerSocket Throughout this book, I use the British convention of placing punctuation inside quotation marks only when punctuation is part of the material quoted Although I learned grammar under the American rules, the British system has always seemed far more logical to me, even more so than usual when one must quote source code where a missing or added comma, period, or semicolon can make the difference between code that compiles and code that doesn't Finally, although many of the examples used here are toy examples unlikely to be reused, a few of the classes I develop have real value Please feel free to reuse them or any parts of them in your own code No special permission is required As far as I am concerned, they are in the public domain (although the same is most definitely not true of the explanatory text!) Such classes are placed somewhere in the com.macfaq package, generally mirroring the java package hierarchy For instance, Chapter 4's SafePrintWriter class is in the com.macfaq.io package When working with these classes, don't forget that the compiled class files must reside in directories matching their package structure inside your class path, and that you'll have to import them in your own classes before you can use them The book's web page at http://www.cafeaulait.org/books/jnp3/ includes a jar file containing all these classes that can be installed in your class path Indicates a tip, suggestion, or general note Indicates a warning or caution < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Request for Comments I enjoy hearing from readers, whether with general comments about this book, specific corrections, other topics you would like to see covered, or just war stories about your own network programming travails You can reach me by sending email to elharo@metalab.unc.edu Please realize, however, that I receive several hundred pieces of email a day and cannot personally respond to each one For the best chances of getting a personal response, please identify yourself as a reader of this book If you have a question about a particular program that isn't working as you expect, try to reduce it to the simplest case that reproduces the bug, preferably a single class, and paste the text of the entire program into the body of your email Unsolicited attachments will be deleted unopened And please, please send the message from the account you want me to reply to and make sure that your Reply-to address is properly set! There's nothing quite so frustrating as spending an hour or more carefully researching the answer to an interesting question and composing a detailed response, only to have it bounce because my correspondent was sending from a public terminal and neglected to set the browser preferences to include their actual email address I also adhere to the old saying "If you like this book, tell your friends If you don't like it, tell me." I'm especially interested in hearing about mistakes This is my eighth book I've yet to publish a perfect one, but I keep trying As hard as I and the editors at O'Reilly worked on this book, I'm sure there are mistakes and typographical errors that we missed here somewhere And I'm sure that at least one of them is a really embarrassing whopper of a problem If you find a mistake or a typo, please let me know so I can correct it I'll post it on the web page for this book at http://www.cafeaulait.org/books/jnp3/ and on the O'Reilly web site at http://www.oreilly.com/catalog/javanetwk/errata/ Before reporting errors, please check one of those pages to see if I already know about it and have posted a fix Any errors that are reported will be fixed in future printings < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Comments and Questions Please address comments and questions concerning this book to the publisher: O'Reilly Media, Inc 1005 Gravenstein Highway North Sebastopol, CA 95472 (800) 998-9938 (in the United States or Canada) (707) 829-0515 (international or local) (707) 829-0104 (fax) There is a web page for this book, which lists errata, examples, and any additional information You can access this page at: http://www.oreilly.com/catalog/javanp3/ To comment on or ask technical questions about this book, send email to: bookquestions@oreilly.com For more information about books, conferences, software, Resource Centers, and the O'Reilly Network, see the O'Reilly web site at: http://www.oreilly.com The author maintains a web site for the discussion of EJB and related distributed computing technologies at http://www.jmiddleware.com jMiddleware.com provides news about this book as well as code tips, articles, and an extensive list of links to EJB resources < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Acknowledgments Many people were involved in the production of this book My editor, Mike Loukides, got this book rolling, and provided many helpful comments along the way that substantially improved the book Dr Peter "Peppar" Parnes helped out immensely with the multicast chapter The technical editors all provided invaluable assistance in hunting down errors and omissions Simon St Laurent provided invaluable advice on which topics deserved more coverage Scott Oaks lent his thread expertise to Chapter 5, proving once again by the many subtle bugs he hunted down that multithreading still requires the attention of an expert Ron Hitchens shone light into many of the darker areas of the new I/O APIs Marc Loy and Jim Elliott reviewed some of the most bleeding edge material in the book Jim Farley and William Grosso provided many helpful comments and assistance on remote method invocation Timothy F Rohaly was unswerving in his commitment to making sure I closed all my sockets and caught all possible exceptions, and in general wrote the cleanest, safest, most exemplary code I could write John Zukowski found numerous errors of omission, all now filled thanks to him And the eagle-eyed Avner Gelb displayed an astonishing ability to spot mistakes that had somehow managed to go unnoticed by myself, all the other editors, and the tens of thousands of readers of the first edition It isn't customary to thank the publisher, but the publisher does set the tone for the rest of the company, authors, editors, and production staff alike; and I think Tim O'Reilly deserves special credit for making O'Reilly Media absolutely one of the best houses an author can write for If there's one person without whom this book would never have been written, it's him If you, the reader, find O'Reilly books to be consistently better than most of the drek on the market, the reason really can be traced straight back to Tim My agent, David Rogelberg, convinced me it was possible to make a living writing books like this rather than working in an office The entire crew at ibiblio.org over the last several years has really helped me to communicate better with my readers in a variety of ways Every reader who sent in bouquets and brickbats about the first and second editions has been instrumental in helping me write this much-improved edition All these people deserve much thanks and credit Finally, as always, I'd like to offer my largest thanks for my wife, Beth, without whose love and support this book would never have happened —Elliotte Rusty Harold elharo@metalab.unc.edu September 22, 2004 < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > Preface Java's growth over the last 10 years has been nothing short of phenomenal Given Java's rapid rise to prominence and the even more spectacular growth of the Internet, it's a little surprising that network programming in Java is still so mysterious to so many It doesn't have to be In fact, writing network programs in Java is quite simple, as this book will show Readers with previous experience in network programming in a Unix, Windows, or Macintosh environment should be pleasantly surprised at how much easier it is to write equivalent programs in Java The Java core API includes welldesigned interfaces to most network features Indeed, there is very little application-layer network software you can write in C or C++ that you can't write more easily in Java Java Network Programming, 3rd Edition endeavors to show you how to take advantage of Java's network class library to quickly and easily write programs that accomplish many common networking tasks Some of these include: Browsing the Web with HTTP Parsing and rendering HTML Sending email with SMTP Receiving email with POP and IMAP Writing multithreaded servers Installing new protocol and content handlers into browsers Encrypting communications for confidentiality, authentication, and guaranteed message integrity Designing GUI clients for network services Posting data to server-side programs Looking up hosts using DNS Downloading files with anonymous FTP Connecting sockets for low-level network communication Distributing applications across multiple systems with Remote Method Invocation Java is the first language to provide such a powerful cross-platform network library, which handles all these diverse tasks Java Network Programming exposes the power and sophistication of this library This book's goal is to enable you to start using Java as a platform for serious network programming To so, this book provides a general background in network fundamentals, as well as detailed discussions of Java's facilities for writing network programs You'll learn how to write Java programs that share data across the Internet for games, collaboration, software updates, file transfer, and more You'll also get a behind-the-scenes look at HTTP, SMTP, TCP/IP, and the other protocols that support the Internet and the Web When you finish this book, you'll have the knowledge and the tools to create the next generation of software that takes full advantage of the Internet < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > • • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Java Network Programming, 3rd Edition By Elliotte Rusty Harold Publisher: O'Reilly Pub Date: October 2004 ISBN: 0-596-00721-3 Pages: 706 Thoroughly revised to cover all the 100+ significant updates to Java Developers Kit (JDK) 1.5, Java Network Programming is a complete introduction to developing network programs (both applets and applications) using Java, covering everything from networking fundamentals to remote method invocation (RMI) It includes chapters on TCP and UDP sockets, multicasting protocol and content handlers, servlets, and the new I/O API This is the essential resource for any serious Java developer < Day Day Up > This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com < Day Day Up > • • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Java Network Programming, 3rd Edition By Elliotte Rusty Harold Publisher: O'Reilly Pub Date: October 2004 ISBN: 0-596-00721-3 Pages: 706 Copyright Preface About the Third Edition Organization of the Book Who You Are Java Versions About the Examples Conventions Used in This Book Request for Comments Comments and Questions Acknowledgments Chapter Why Networked Java? Section 1.1 What Can a Network Program Do? Section 1.2 Security Section 1.3 But Wait! There's More! Chapter Basic Network Concepts Section 2.1 Networks Section 2.2 The Layers of a Network Section 2.3 IP, TCP, and UDP Section 2.4 The Internet Section 2.5 The Client/Server Model Section 2.6 Internet Standards Chapter Basic Web Concepts Section 3.1 URIs Section 3.2 HTML, SGML, and XML Section 3.3 HTTP Section 3.4 MIME Media Types This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Section 3.5 Server-Side Programs Chapter Streams Section 4.1 Output Streams Section 4.2 Input Streams Section 4.3 Filter Streams Section 4.4 Readers and Writers Chapter Threads Section 5.1 Running Threads Section 5.2 Returning Information from a Thread Section 5.3 Synchronization Section 5.4 Deadlock Section 5.5 Thread Scheduling Section 5.6 Thread Pools Chapter Looking Up Internet Addresses Section 6.1 The InetAddress Class Section 6.2 Inet4Address and Inet6Address Section 6.3 The NetworkInterface Class Section 6.4 Some Useful Programs Chapter URLs and URIs Section 7.1 The URL Class Section 7.2 The URLEncoder and URLDecoder Classes Section 7.3 The URI Class Section 7.4 Proxies Section 7.5 Communicating with Server-Side Programs Through GET Section 7.6 Accessing Password-Protected Sites Chapter HTML in Swing Section 8.1 HTML on Components Section 8.2 JEditorPane Section 8.3 Parsing HTML Section 8.4 Cookies Chapter Sockets for Clients Section 9.1 Socket Basics Section 9.2 Investigating Protocols with Telnet Section 9.3 The Socket Class Section 9.4 Socket Exceptions Section 9.5 Socket Addresses Section 9.6 Examples Chapter 10 Sockets for Servers Section 10.1 The ServerSocket Class Section 10.2 Some Useful Servers Chapter 11 Secure Sockets Section 11.1 Secure Communications Section 11.2 Creating Secure Client Sockets Section 11.3 Methods of the SSLSocket Class Section 11.4 Creating Secure Server Sockets Section 11.5 Methods of the SSLServerSocket Class Chapter 12 Non-Blocking I/O Section 12.1 An Example Client Section 12.2 An Example Server Section 12.3 Buffers Section 12.4 Channels Section 12.5 Readiness Selection Chapter 13 UDP Datagrams and Sockets This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Chapter 13 UDP Datagrams and Sockets Section 13.1 The UDP Protocol Section 13.2 The DatagramPacket Class Section 13.3 The DatagramSocket Class Section 13.4 Some Useful Applications Section 13.5 DatagramChannel Chapter 14 Multicast Sockets Section 14.1 What Is a Multicast Socket? Section 14.2 Working with Multicast Sockets Section 14.3 Two Simple Examples Chapter 15 URLConnections Section 15.1 Opening URLConnections Section 15.2 Reading Data from a Server Section 15.3 Reading the Header Section 15.4 Configuring the Connection Section 15.5 Configuring the Client Request HTTP Header Section 15.6 Writing Data to a Server Section 15.7 Content Handlers Section 15.8 The Object Methods Section 15.9 Security Considerations for URLConnections Section 15.10 Guessing MIME Content Types Section 15.11 HttpURLConnection Section 15.12 Caches Section 15.13 JarURLConnection Chapter 16 Protocol Handlers Section 16.1 What Is a Protocol Handler? Section 16.2 The URLStreamHandler Class Section 16.3 Writing a Protocol Handler Section 16.4 More Protocol Handler Examples and Techniques Section 16.5 The URLStreamHandlerFactory Interface Chapter 17 Content Handlers Section 17.1 What Is a Content Handler? Section 17.2 The ContentHandler Class Section 17.3 The ContentHandlerFactory Interface Section 17.4 A Content Handler for the FITS Image Format Chapter 18 Remote Method Invocation Section 18.1 What Is Remote Method Invocation? Section 18.2 Implementation Section 18.3 Loading Classes at Runtime Section 18.4 The java.rmi Package Section 18.5 The java.rmi.registry Package Section 18.6 The java.rmi.server Package Chapter 19 The JavaMail API Section 19.1 What Is the JavaMail API? Section 19.2 Sending Email Section 19.3 Receiving Mail Section 19.4 Password Authentication Section 19.5 Addresses Section 19.6 The URLName Class Section 19.7 The Message Class Section 19.8 The Part Interface Section 19.9 Multipart Messages and File Attachments Section 19.10 MIME Messages This document is created with a trial version of CHM2PDF Pilot http://www.colorpilot.com Section 19.11 Folders Colophon Index < Day Day Up > ... pay this?" The user can then click buttons that say "Yes" or "No" If the user clicks the No button, then they don't get into the site Now let's imagine what happens if the user clicks Yes The... signs the order with the buyer's private key The applet next sends the data back to the server over the network The server grants the user access to the requested information using the standard HTTP... declaration like this: public void setTimeToLive(int ttl) throws IOException // Java 1.2 To further muddy the waters, there are multiple versions of Java At the time this book was completed, the current