Modify the Resource Class

In this step of the tutorial, the generated Resource class (FilesystemResource) is modified to implement the init method as well as several methods for the filesystem's custom operations. The Resource class is the stateful instance-representation of your Web service. The resource maintains the resource id and the ResourcePropertySet. The resource id is the unique identifier for an instance of your Web service. It allows you to have multiple resource instances, each with their own states, fronted by the same Web service. The stateful properties are represented by the ResourcePropertySet. The ResourcePropertySet is the Java representation of the Resource Properties document defined in the types section of your WSDL file.

Open WORK_DIR/generated/filesystem/src/java/org/apache/ws/resource/example/filesystem/FilesystemResource.java and replace the public void init() method with the following method. You will also need to copy the custom operation methods below.

    			
    /*
     * An mock object representing the filesystem being exposed as a WS-Resource.
     */
    private example.filesystem.backend.FileSystem m_filesystem;
			
    /**
     * Initializes this resource's state (properties, etc.).
     */
    public void init()
    {
        super.init();
        m_filesystem = new example.filesystem.backend.UnixFileSystem( (String)getID() );  // create a mock object representing the backend filesystem

        /*
         * The resource property set which contains all of resource properties that were defined in the WSDL.
         */
        org.apache.ws.resource.properties.ResourcePropertySet resourcePropertySet = getResourcePropertySet();
        org.apache.ws.resource.properties.ResourceProperty resourceProperty;

        try
        {
            /*
             * Initialize each of our properties by calling resourceProperty.add(propElem) and/or resourceProperty.setCallback(callback)...
             */
            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.DEVICESPECIALFILE );
            DeviceSpecialFileDocument deviceDocXBean = DeviceSpecialFileDocument.Factory.newInstance();
            deviceDocXBean.setDeviceSpecialFile( m_filesystem.getDeviceSpecialFile() );
            resourceProperty.add( deviceDocXBean );
            resourceProperty.getMetaData().setReadOnly( true );

            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.TYPE );
            TypeDocument typeDocXBean = TypeDocument.Factory.newInstance();
            typeDocXBean.setType( m_filesystem.getType() );
            resourceProperty.add( typeDocXBean );
            resourceProperty.getMetaData().setReadOnly( true );

            BackupFrequencyDocument backupDocXBean = BackupFrequencyDocument.Factory.newInstance();
            backupDocXBean.setBackupFrequency( m_filesystem.getBackupFrequency() );
            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.BACKUPFREQUENCY );
            resourceProperty.add( backupDocXBean );
            resourceProperty.setCallback( new example.filesystem.callback.BackupFrequencyCallback( m_filesystem ) );

            CommentDocument commentDocXBean = CommentDocument.Factory.newInstance();
            commentDocXBean.setComment( m_filesystem.getComment() );
            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.COMMENT );
            resourceProperty.add( commentDocXBean );
            resourceProperty.setCallback( new example.filesystem.callback.CommentCallback( m_filesystem ) );

            FsckPassNumberDocument fsckDocXBean = FsckPassNumberDocument.Factory.newInstance();
            fsckDocXBean.setFsckPassNumber( m_filesystem.getFsckPassNumber() );
            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.FSCKPASSNUMBER );
            resourceProperty.add( fsckDocXBean );
            resourceProperty.setCallback( new example.filesystem.callback.FsckPassNumberCallback( m_filesystem ) );

            MountPointDirectoryDocument mountPointDocXBean = MountPointDirectoryDocument.Factory.newInstance();
            mountPointDocXBean.setMountPointDirectory( m_filesystem.getMountPoint() );
            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.MOUNTPOINTDIRECTORY );
            resourceProperty.add( mountPointDocXBean );
            resourceProperty.setCallback( new example.filesystem.callback.MountPointCallback( m_filesystem ) );

            OptionsDocument optionsDocXBean =
                    OptionsDocument.Factory.newInstance();
            org.apache.ws.resource.example.filesystem.OptionsDocument.Options options =
                    optionsDocXBean.addNewOptions();
            java.util.List backendOptions =
                    m_filesystem.getOptions();
            for ( int i = 0; i < backendOptions.size(); i++ )
            {
                options.addOption( (String) backendOptions.get( i ) );
            }

            resourceProperty = resourcePropertySet.get( FilesystemPropertyQNames.OPTIONS );
            resourceProperty.add( optionsDocXBean );
            resourceProperty.setCallback( new example.filesystem.callback.OptionsCallback( m_filesystem ) );

        }
        catch ( Exception e )
        {
            throw new javax.xml.rpc.JAXRPCException( "There was a problem in initializing your resource properties.  Please check your init() method. Cause: " +
                    e.getLocalizedMessage() );
        }

        // Resource Property {http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd}TerminationTime is implemented by the framework.
        // Resource Property {http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd}CurrentTime is implemented by the framework.
    }
    
    public void mount() throws Exception
    {
        m_filesystem.mount();
    }

    public void unmount() throws Exception
    {
        m_filesystem.unmount();
    }

    public boolean isMounted()
    {
        return m_filesystem.isMounted();
    }    

Back Next