Add to, update, or delete part of an application through programming

We can add to, update, or delete part of an existing application through the administrative console, the wsadmin tool, or programming. This example changes part of an application through programming. You can use this example whether we add to, update, or delete part of an existing application. Multiple changes to an application can be packaged in a single compressed .zip file.

To learn about the structure of the compressed .zip file, see updating applications through the administrative console. This task assumes a basic familiarity with MBean programming. For information on MBean programming, see MBean Java application programming interface (API) documentation. In this information center, click Reference > Mbean interfaces.

Before we can add to, update, or delete part of an application on WebSphere Application Server, install the application.

Perform the following tasks to add to, update, or delete part of an application through programming.

Tasks

1. Connect to WAS.

2. Create the application management proxy.

3. Create the notification filter.

4. Add the listener.
5. Partially change the existing application.
6. Wait for some timeout so that the program does not end.
7. Listen to Java Management Extensions (JMX) notifications to understand completion of the operation.

After you successfully run the code, we have changed the application.

Example

The following example shows how to add to, update, or delete part of an application based on the previous steps. Some statements are split on multiple lines for printing purposes.

//Inputs: 
//partialApp specifies the location of the partial application.
//appName specifies the name of the application.

(Windows)

String partialApp = "C:\apps\partial.zip";

(Linux) (HPUX) (Solaris) (AIX) (ZOS) (iSeries)

String partialApp = "/apps/partial.zip";

String appName = "MyApp";

//Do a get of the administrative client to connect to the product.

AdminClient client = ...;

//Create the application management proxy.
AppManagement proxy = AppManagementProxy.getJMXProxyForClient (client);

// Create the notification filter.   
NotificationFilterSupport myFilter = new NotificationFilterSupport();
myFilter.enableType (NotificationConstants.TYPE_APPMANAGEMENT);
//Add the listener.   
NotificationListener listener = new AListener(_soapClient, myFilter, 
"Install: " + appName, AppNotification.UPDATE); 
//Partially change the existing application, MyApp.

Hashtable options = new Hashtable();
options.put (AppConstants.APPDEPL_LOCALE, Locale.getDefault());
options.put (AppConstants.APPUPDATE_CONTENTTYPE, AppConstants.APPUPDATE_CONTENT_PARTIALAPP);

proxy.updateApplication (	appName, 
				null, 
				partialApp,
				null,
				options,
				null);

// Wait for some timeout. The installation API is 
//  asynchronous and so returns immediately. 
// If the program does not wait here, the program ends.
  Thread.sleep(300000); // Wait so that the program does not end.
        }
        catch (Exception e) {
            e.printStackTrace();
        }
    }
}
// Specify the Java Management Extensions (JMX) notification listener for JMX events.
class AListener implements NotificationListener
{
    AdminClient _soapClient;
    NotificationFilterSupport  myFilter;
    Object handback;
    ObjectName on;
    String eventTypeToCheck;

    public AListener(AdminClient cl, NotificationFilterSupport fl, 
Object h, String eType) throws Exception
    {
        _soapClient = cl;
        myFilter = fl;
        handback = h;
        eventTypeToCheck = eType;

        Iterator iter = _soapClient.queryNames (new ObjectName(
"WebSphere:type=AppManagement,*"), null).iterator();
        on = (ObjectName)iter.next();
        System.out.println ("ObjectName: " + on);
        _soapClient.addNotificationListener (on, this, myFilter, handback);
    }

    public void handleNotification (Notification notf, Object handback)
    {
            AppNotification ev = (AppNotification) notf.getUserData();
            System.out.println ("!! JMX event Recd: (handback obj= " + handback+ "): " + ev);

            //When the installation is done, remove the listener and quit

            if (ev.taskName.equals (eventTypeToCheck) &&
                (ev.taskStatus.equals (AppNotification.STATUS_COMPLETED) ||
                 ev.taskStatus.equals (AppNotification.STATUS_FAILED)))
            {
                    try
                    {
                            _soapClient.removeNotificationListener (on, this);
                    }
            catch (Throwable th)
                    {
                        System.out.println ("Error removing listener: " + th);
                    }
                    System.exit (0);
        }
    }
}

What to do next

After updating the application, remove the listener and quit.

Install an application through programming

Update enterprise application files

Uninstall an application through programming

Update an application through programming

Prepare a module and adding it to an existing application through programming

Prepare and updating a module through programming

Deleting a module through programming

Add a file through programming

Update a file through programming

Deleting a file through programming