Home » Adobe Manuals » Computer Software » Adobe 38000382 » Manual Viewer

Adobe 38000382 JRun Guide - Page 108

Editing XML files, JRun Programmer's Guide

UPC - 718659575946

Add to My Manuals
Save this manual to your list of manuals

Page 108 highlights

Editing XML files OEMs often must hide the underlying application server from customers who use their applications. They want their customers to know only about the application that is running and not about the underlying server technology. As an OEM, you or your support personnel, might need a way to access the application server settings. The most common function you might do is to programmatically edit XML files. This provides you with a very granular level of control over the behavior of JRun. For example, by editing the JRun configuration XML files (such as jrun.xml), you can add and remove services, and change the attributes of those services. You can also edit the J2EE XML files, such as web.xml and application.xml. This lets you add and remove servlet definitions, servlet filters, EJBs, security settings, and anything available in those XML files. The following table briefly describes the useful elements that you can edit in each of the XML files used by JRun: XML file jrun.xml web.xml jrun-resources.xml ejb-jar.xml jrun-web.xml application.xml Common elements Defines JRun core services, such as: • JRunServer • SchedulerService • LoggerService • JRunSecurityManagerService • ServletEngineService • MailService • DeployerService Defines web application settings, including the following: • Servlet definitions • Event listeners • Servlet filters • Security constraints • Error pages Defines resources used by the JRun server, including the following: • JMS Connection factories • JDBC data sources Defines EJBs. Defines virtual path mappings. Defines web modules and their context roots. For more information about the XML files used by JRun, see JRun Programmer's Guide. 94 Chapter 9 Editing XML Files

Section	Page
JRun SDK Guide	1
Contents	3
About This Book	7
Developer resources	8
About JRun documentation	9
Printed and online documentation set	9
Accessing online documentation	9
Other resources	10
Contacting Macromedia	13
Introduction to the SDK	15
About the JRun SDK	16
Getting the SDK	16
SDK/retail differences	16
Software requirements	17
SDK file group	18
Core components	18
JRun components	19
JRun source code	20
JRun installers	20
SDK documentation	21
JRun Installer Overview	23
Installer overview	24
Configuring JRun during installation	25
Custom software requirements	25
User input during installation	25
Setting ports	26
Setting the JMC username and password	27
Working with JRun licenses	27
Installing multiple instances of JRun	27
Building a customized version of JRun	28
Building JRun	28
Choose components	28
Setting the language	29
Setting the platform	29
Setting the destination directory	29
Windows JRun Installers	31
Overview of Windows installations	32
Windows Installer environments	32
Non-Windows Installer environments	32
Customizing JRun installers with Windows Installer	33
About merge modules	33
Working with merge modules	33
Merge module list	34
Working with InstallShield Developer 7	35
Determining merge module location	35
Connecting a merge module	36
Using Windows Installer on the command line	38
Using the Windows Installer wrapper	39
Platform-Independent JRun Installers	41
About files for custom installations	42
Using BIN files	42
BIN file list	42
BIN file properties	43
Embedding JRun	45
Connecting to external web servers	46
Silently running the Web Server Configuration tool	46
Including the Web Server Configuration tool in the installer	47
Working with web applications	48
Hiding JSP source code	48
Adding web applications	49
Removing web applications	49
Hiding the JMC	50
Rebranding JRun tools	51
Rebranding the Web Server Configuration tool	51
Rebranding the JRun Launcher	54
Rebranding the JMC	56
JMC source code overview	56
Creating a custom JRun interface	58
Hiding the JMC	58
Deploying applications outside the JRun directory structure	58
Using exit handlers	59
JRunExitHandler interface	59
Exit handler example	59
Exit codes	60
Using the JMC Custom Tag Library	61
Extracting the JMC custom tag library	62
Strategies for working with the JMC custom tags	63
Finding services, classes, and methods	63
Using the service and server attributes	63
Using the mbean attribute	64
Understanding offline properties	64
Using the errorId attribute	65
Using the type and id attributes	65
JMC custom tags reference	66
add	66
addOfflinePropertyValue	68
checkServer	68
getConfiguration	69
getOfflineProperty	70
getOfflinePropertyValues	71
getProperty	71
getServer	72
getServersOnHost	73
invoke	73
isRemoteServer	75
objects	75
parameter	76
removeAllOfflinePropertyValues	77
remove	77
setOfflineProperty	79
setProperty	79
status	80
JRun APIs	81
Using the JRun API Javadocs	82
JRun APIs overview	83
Command-line tools	86
Using the GetControlPort tool	86
Using the migration tool	87
Using Base64 encoder	87
Using the Web Server Configuration tool	87
Using the jrun command	88
Using the jrunsvc tool	88
Using the JSPC tool	89
Using XMLScript	89
Using Java2WSDL	89
Using WSDL2Java	90
JRun executables	91
JRun Services	93
Service architecture (JMX)	94
Creating services	96
Basic JRun services: extending ServiceMBean and ServiceAdapter	96
Service naming convention	96
Service composition: extending ServicePartitionMBean and ServicePartition	96
Creating services using jrun.xml	97
Creating services programmatically	98
Custom service example	99
Accessing JRun services	103
Best practices	103
JNDI	103
Service convenience methods	104
JMX	104
Adding JRun service security	105
Loading MBeans through MLETs	106
Editing XML Files	107
Editing XML files	108
Tools for editing XML files	109
Understanding the XML metadata classes	110
Using XML metadata	111
Strategies	112
Comments	112
Finding metadata classes	112
XML metadata example	113