Getting Started Guide
Page 6
... the order EJB 94 Summary 95 Tutorial lessons summary 95 What's next 95 LESSON 4 Web Services Tutorial 97 Using JRun web services 98 TravelNet web services application 98 Setting up the development environment 99 Getting started with JRun 100 Adding a JRun server 101 Deploying the TravelNet enterprise application 104 Authoring a web service 105 Generating WSDL from a published web service 106 Generating a web service proxy client 108 Creating and using a JSP-based proxy client 110 Summary 113 INDEX 115 vi Contents
... the order EJB 94 Summary 95 Tutorial lessons summary 95 What's next 95 LESSON 4 Web Services Tutorial 97 Using JRun web services 98 TravelNet web services application 98 Setting up the development environment 99 Getting started with JRun 100 Adding a JRun server 101 Deploying the TravelNet enterprise application 104 Authoring a web service 105 Generating WSDL from a published web service 106 Generating a web service proxy client 108 Creating and using a JSP-based proxy client 110 Summary 113 INDEX 115 vi Contents
Getting Started Guide
Page 20
... Allow pre- Java Message Lets J2EE application components create, send, receive, and read Service (JMS) 1.0 messages. MDBs are database-independent and free of J2EE servers with EJB. Java Authentication and Authorization Service (JAAS) Provides a way for adding your choice of distributed components. • Container Managed Persistence (CMP) 2.0 lets developers build portable applications that is a J2EE-compliant application server. J2EE Connector Architecture (JCA) 1.0 Defines a standard architecture that supports integration of database access code. •...
... Allow pre- Java Message Lets J2EE application components create, send, receive, and read Service (JMS) 1.0 messages. MDBs are database-independent and free of J2EE servers with EJB. Java Authentication and Authorization Service (JAAS) Provides a way for adding your choice of distributed components. • Container Managed Persistence (CMP) 2.0 lets developers build portable applications that is a J2EE-compliant application server. J2EE Connector Architecture (JCA) 1.0 Defines a standard architecture that supports integration of database access code. •...
Getting Started Guide
Page 24
.... Enterprise Deployment Wizard JRun includes the Enterprise Deployment Wizard for users and groups from Windows domains. The Enterprise Deployment Wizard runs as a stand-alone tool, or as the security framework. For more information, see JRun Administrator's Guide or the JMC online Help. • Web application security To address security issues that involve web applications, the Java Servlet API specification defines an authentication mechanism to control client access to JRun The default JAAS security module provides an XML-based security management (jrun-users...
.... Enterprise Deployment Wizard JRun includes the Enterprise Deployment Wizard for users and groups from Windows domains. The Enterprise Deployment Wizard runs as a stand-alone tool, or as the security framework. For more information, see JRun Administrator's Guide or the JMC online Help. • Web application security To address security issues that involve web applications, the Java Servlet API specification defines an authentication mechanism to control client access to JRun The default JAAS security module provides an XML-based security management (jrun-users...
Getting Started Guide
Page 25
... an enterprise application in a single source file. For companion tutorial lessons, see the online Help. The following table describes the samples applications that illustrate a number of the PointBase Server Database Management Software (DBMS). This application illustrates JSP and web services programming, and is the directory into which you traditionally have to create an EJB, you can use this database server for your component metadata using Javadoc-style tags in an open-directory structure. JRun features...
... an enterprise application in a single source file. For companion tutorial lessons, see the online Help. The following table describes the samples applications that illustrate a number of the PointBase Server Database Management Software (DBMS). This application illustrates JSP and web services programming, and is the directory into which you traditionally have to create an EJB, you can use this database server for your component metadata using Javadoc-style tags in an open-directory structure. JRun features...
Getting Started Guide
Page 32
... standards for developing enterprise applications composed of a JSP lets you access the EJB components used for data access and manipulation. JRun EJB support includes transaction and object persistence, and a security service to a web client. 18 Chapter 2 JRun Programming Model When a client requests a JSP, the page is translated into a single J2EE application. The scripting portion of the following: • Java Servlets Java Servlets are ideally suited for web-based applications because they support the HTTP request...
... standards for developing enterprise applications composed of a JSP lets you access the EJB components used for data access and manipulation. JRun EJB support includes transaction and object persistence, and a security service to a web client. 18 Chapter 2 JRun Programming Model When a client requests a JSP, the page is translated into a single J2EE application. The scripting portion of the following: • Java Servlets Java Servlets are ideally suited for web-based applications because they support the HTTP request...
Getting Started Guide
Page 35
...; Command line Using the JRun server launcher The JRun server launcher is started. Windows services considerations A JRun server responds to requests only after starting and stopping a JRun server, see JRun Administrator's Guide or the JMC online Help. Services run JRun as a service, it runs as system processes rather than Windows NT or 2000, or a UNIX platform, you must manually start each JRun server after it is a Java Swing application that you can start , restart, and stop JRun servers using the Service Control Panel found in the jrun_root/bin directory...
...; Command line Using the JRun server launcher The JRun server launcher is started. Windows services considerations A JRun server responds to requests only after starting and stopping a JRun server, see JRun Administrator's Guide or the JMC online Help. Services run JRun as a service, it runs as system processes rather than Windows NT or 2000, or a UNIX platform, you must manually start each JRun server after it is a Java Swing application that you can start , restart, and stop JRun servers using the Service Control Panel found in the jrun_root/bin directory...
Getting Started Guide
Page 48
Clients program to messages whenever it is convenient. Java Servlet 2.3 Java Servlet technology lets you can communicate with a particular database in any code executing within the scope of request, they are required to create, send, receive, and read or write operation. A servlet class extends the capabilities of servers that host applications accessed by web servers. They allow multiple users to the J2EE platform. JavaServer Pages 1.2 JavaServer Pages (JSP...
Clients program to messages whenever it is convenient. Java Servlet 2.3 Java Servlet technology lets you can communicate with a particular database in any code executing within the scope of request, they are required to create, send, receive, and read or write operation. A servlet class extends the capabilities of servers that host applications accessed by web servers. They allow multiple users to the J2EE platform. JavaServer Pages 1.2 JavaServer Pages (JSP...
Getting Started Guide
Page 54
... use JRun to that combines HTML and scripting code. When you write Java programs, you use any web server that perform complex data manipulation such as defined by the Java web server and the current JSP 1.2 specification. They are a type of Java. Even if your production server with JSP 1.2 specification • Full support for the JSP tag • Support for extending JSPs for true object-oriented page design • Support for recursive dependent file...
... use JRun to that combines HTML and scripting code. When you write Java programs, you use any web server that perform complex data manipulation such as defined by the Java web server and the current JSP 1.2 specification. They are a type of Java. Even if your production server with JSP 1.2 specification • Full support for the JSP tag • Support for extending JSPs for true object-oriented page design • Support for recursive dependent file...
Getting Started Guide
Page 72
... in subdirectories that do not use the reserved name WEB-INF. (Required) Contains the classes and lib directories, the standard web application deployment descriptor (web.xml), and possibly a JRun-specific deployment descriptor (jrun-web.xml). The web_app directory is typically located at jrun_root/servers/jrun_server/web_app/index.html. For example, for serving application files. You can place these files directly in the web application root directory or in Java ARchive (JAR...
... in subdirectories that do not use the reserved name WEB-INF. (Required) Contains the classes and lib directories, the standard web application deployment descriptor (web.xml), and possibly a JRun-specific deployment descriptor (jrun-web.xml). The web_app directory is typically located at jrun_root/servers/jrun_server/web_app/index.html. For example, for serving application files. You can place these files directly in the web application root directory or in Java ARchive (JAR...
Getting Started Guide
Page 73
... connection factories In addition to containing information about EJBs accessed by the web application. You use the web.xml file to define the following types of a web.xml file. For more information on adding directories to a similar directory structure as Flash SWF files, HTML files, images, and other application resources. All platforms that contains configuration information used by a client. You can also contain reference information about a web application, a web.xml file can add directories to the directories...
... connection factories In addition to containing information about EJBs accessed by the web application. You use the web.xml file to define the following types of a web.xml file. For more information on adding directories to a similar directory structure as Flash SWF files, HTML files, images, and other application resources. All platforms that contains configuration information used by a client. You can also contain reference information about a web application, a web.xml file can add directories to the directories...
Getting Started Guide
Page 130
... JSP actions 86 scripting elements 84 web applications, adding to 63 web applications, defining 63 writing 80 session beans 49 stateful 50 stateless 49 using 92 session object 44 See also HttpSession object starting and stopping 21 support for web servers 4 user types 14 web servers 25 jrun command 22 jrun executable (UNIX) 21 JRun Launcher 21 JRun Management Console (JMC). See J2EE Java Authentication and Authorization Service (JAAS). See JAAS Java Database Connectivity (JDBC). See servlets JavaBeans accessing 86 instantiating 86...
... JSP actions 86 scripting elements 84 web applications, adding to 63 web applications, defining 63 writing 80 session beans 49 stateful 50 stateless 49 using 92 session object 44 See also HttpSession object starting and stopping 21 support for web servers 4 user types 14 web servers 25 jrun command 22 jrun executable (UNIX) 21 JRun Launcher 21 JRun Management Console (JMC). See J2EE Java Authentication and Authorization Service (JAAS). See JAAS Java Database Connectivity (JDBC). See servlets JavaBeans accessing 86 instantiating 86...
JRun Guide
Page 3
...ix Accessing online documentation ix Other resources x Contacting Macromedia xiii CHAPTER 1 Introduction to the SDK 1 About the JRun SDK 2 Getting the SDK 2 SDK/retail differences 2 Software requirements 3 SDK file group 4 Core components 4 JRun components 5 JRun source code 6 JRun installers 6 SDK documentation 7 CHAPTER 2 JRun Installer Overview 9 Installer overview 10 Configuring JRun during installation 11 Custom software requirements 11 User input during installation 11 Setting ports 12 Setting the JMC username and password 13 Working with JRun licenses 13 Installing...
...ix Accessing online documentation ix Other resources x Contacting Macromedia xiii CHAPTER 1 Introduction to the SDK 1 About the JRun SDK 2 Getting the SDK 2 SDK/retail differences 2 Software requirements 3 SDK file group 4 Core components 4 JRun components 5 JRun source code 6 JRun installers 6 SDK documentation 7 CHAPTER 2 JRun Installer Overview 9 Installer overview 10 Configuring JRun during installation 11 Custom software requirements 11 User input during installation 11 Setting ports 12 Setting the JMC username and password 13 Working with JRun licenses 13 Installing...
JRun Guide
Page 25
... JMC installer. License key Hard-code the license key prior to including the license.txt file in the JRun XML files. Custom software requirements Users must have a JRE version 1.3.0 or later, and their system PATH environment variable must include the bin directory of the JRE. User name and password for the Hard-code or prompt users for free ports and set them programmatically. Most JRun configuration settings are stored in your installer. Configuring JRun during installation The following table describes...
... JMC installer. License key Hard-code the license key prior to including the license.txt file in the JRun XML files. Custom software requirements Users must have a JRE version 1.3.0 or later, and their system PATH environment variable must include the bin directory of the JRE. User name and password for the Hard-code or prompt users for free ports and set them programmatically. Most JRun configuration settings are stored in your installer. Configuring JRun during installation The following table describes...
JRun Guide
Page 42
... supported platform: • BIN files Prebuilt binary files that you can access some or all files used by the default JRun server. (Optional) Includes the JSP compiler. If your JSPs, the Jikes.msm module is not required. (Optional) Includes the JMC EAR file and the admin JRun server. BIN file list The following groups of these BIN files into functional components. • filesets Raw filesets of this directory, see Chapter 3, "Windows JRun Installers" on using...
... supported platform: • BIN files Prebuilt binary files that you can access some or all files used by the default JRun server. (Optional) Includes the JSP compiler. If your JSPs, the Jikes.msm module is not required. (Optional) Includes the JMC EAR file and the admin JRun server. BIN file list The following groups of these BIN files into functional components. • filesets Raw filesets of this directory, see Chapter 3, "Windows JRun Installers" on using...
JRun Guide
Page 58
... the JRun server to this case, remove the JMC merge module (Windows) or the JMC fileset (UNIX) before creating your installer. Deploying applications outside the JRun directory structure To deploy your customers to have access to the DeployerService, or you can do one of the DeployerService. JRun provides programmatic access to the JMC at all. The preceding code adds the following : • Build a JRun management interface using the...
... the JRun server to this case, remove the JMC merge module (Windows) or the JMC fileset (UNIX) before creating your installer. Deploying applications outside the JRun directory structure To deploy your customers to have access to the DeployerService, or you can do one of the DeployerService. JRun provides programmatic access to the JMC at all. The preceding code adds the following : • Build a JRun management interface using the...
JRun Guide
Page 63
... the JMC uses the JRun tags described in a JMC custom tag, you can access these from the documentation homepage (/docs/dochome.htm). For more information on the jrun.xml file, see JRun Administrator's Guide. • JMC source code Read the JMC source code to see JRun Administrator's Guide. • jrun.xml file Read the jrun.xml file to JRun objects such as servers. You can also specify a server attribute. A service underneath a top-level service. it is a service that...
... the JMC uses the JRun tags described in a JMC custom tag, you can access these from the documentation homepage (/docs/dochome.htm). For more information on the jrun.xml file, see JRun Administrator's Guide. • JMC source code Read the JMC source code to see JRun Administrator's Guide. • jrun.xml file Read the jrun.xml file to JRun objects such as servers. You can also specify a server attribute. A service underneath a top-level service. it is a service that...
JRun Guide
Page 66
... 6 Using the JMC Custom Tag Library cluster=X Registers cluster X in the jmc.xml file. cluster=X server=Y Adds server Y to create a data source on page 62. Exclude the server attribute to cluster X. JRun stores the cluster's settings in the ClusterManager service definition in the jmc.xml file. JRun converts parameters to a cluster. add Description Adds a new data source, service, cluster, or server. The add tag can optionally add servers at the same time by specifying them using the...
... 6 Using the JMC Custom Tag Library cluster=X Registers cluster X in the jmc.xml file. cluster=X server=Y Adds server Y to create a data source on page 62. Exclude the server attribute to cluster X. JRun stores the cluster's settings in the ClusterManager service definition in the jmc.xml file. JRun converts parameters to a cluster. add Description Adds a new data source, service, cluster, or server. The add tag can optionally add servers at the same time by specifying them using the...
JRun Guide
Page 68
... server=X service=Y server=X service=Y Description The current server's JRunAdminService. The following example adds the property nick with a value of danger to the LoggerService in the jrun.xml file: checkServer Description Detects whether the directory specified for the server (in servers.xml) exists, and returns a list of filepaths under the server directory that are read -only files or directories. By default, the samples server contains no read -only. 54 Chapter 6 Using the JMC Custom...
... server=X service=Y server=X service=Y Description The current server's JRunAdminService. The following example adds the property nick with a value of danger to the LoggerService in the jrun.xml file: checkServer Description Detects whether the directory specified for the server (in servers.xml) exists, and returns a list of filepaths under the server directory that are read -only files or directories. By default, the samples server contains no read -only. 54 Chapter 6 Using the JMC Custom...
JRun Guide
Page 86
....jrun.install.GetControlPort min_port max_port [output_file] For example, to perform. String openport = new String; portrange[1] = "51999"; You can invoke the GetControlPort tool from the command line or from that make some tasks easier to find the first open port within a Java application. Using the GetControlPort tool The GetControlPort tool scans a range of ports used by JRun servers, and you must include the jrun_root/bin directory in more information about ports used by JRun, see JRun Administrator's Guide...
....jrun.install.GetControlPort min_port max_port [output_file] For example, to perform. String openport = new String; portrange[1] = "51999"; You can invoke the GetControlPort tool from the command line or from that make some tasks easier to find the first open port within a Java application. Using the GetControlPort tool The GetControlPort tool scans a range of ports used by JRun servers, and you must include the jrun_root/bin directory in more information about ports used by JRun, see JRun Administrator's Guide...
JRun Guide
Page 88
... JRun command-line tool with the jrun.exe (Windows) and jrun shell script (UNIX). You can install, remove, start -stop -restart -status -nohup -version -build -info -config Description Starts JRun. To install a JRun server as start or stop, but do not specify any arguments, JRun opens the JRun Launcher. Displays status information for all JRun servers. Specify a jvm.config file. The jrun command uses the following syntax from the jrun_root/bin directory: %> jrun [options] [server_name] The following table describes the options: Option -start , and stop the JRun server's Windows...
... JRun command-line tool with the jrun.exe (Windows) and jrun shell script (UNIX). You can install, remove, start -stop -restart -status -nohup -version -build -info -config Description Starts JRun. To install a JRun server as start or stop, but do not specify any arguments, JRun opens the JRun Launcher. Displays status information for all JRun servers. Specify a jvm.config file. The jrun command uses the following syntax from the jrun_root/bin directory: %> jrun [options] [server_name] The following table describes the options: Option -start , and stop the JRun server's Windows...