Métodos proxy CcFile y CcDirectory

Un recurso CcFile o CcDirectory representa un archivo o directorio en una vista Rational ClearCase (CcView). Estos recursos se encuentran o pueden colocarse bajo el control de origen. CcFile y CcDirectory son una extensión específica de ClearCase de la API de Cm. CcFile amplía la interfaz ControllableResource y CcDirectory amplía la interfaz ControllableFolder. CcFile da soporte a varios métodos, como los siguientes:

La API de CM distingue entre un CcFile, que es el archivo en una vista a través del cual se llevan a cabo las operaciones anteriores, y el elemento ClearCase subyacente y la versión (CcElement y CcVersion) a la cual se asocia.

El método CcFile.doVersionControl() crear un recurso CcElement y un recurso CcVersion inicial, que tendrá el mismo contenido que el CcFile.

El fragmento de código siguiente crea un proxy CcFile para un archivo conocido de un área de archivo y extrae dicho archivo. La propiedad IS_CHECKED_OUT se selecciona antes y después de la operación de extracción.
 // Get the ClearCase provider.
        CcProvider provider = ...;

        // Create a CcFile proxy for the file to be checked out.
        // First, create a plain old Java "File" instance from the file's path.
        // Then create an StpLocation instance from that file.
        // Finally, create a CcFile proxy from the location.
        File file = new File("C:/my_views/example_view/avob/example.txt");
        StpLocation fileLoc = provider.filePathLocation(Domain.CLEAR_CASE, file);
        CcFile testFile = provider.ccFile(fileLoc);

        // Create a property request for the file's properties that we're
        // interested in.  Read those properties.  Note that the resulting
        // property values are available *only* in the CcFile proxy returned by
        // doReadProperties(), not in the original proxy.
        PropertyRequest wantedProps = new PropertyRequest(
                CcFile.IS_VERSION_CONTROLLED,
                CcFile.IS_CHECKED_OUT);
        testFile = (CcFile) testFile.doReadProperties(wantedProps);

        if ( ! testFile.getIsVersionControlled()) {
            // The file is not yet under version control, so control it.
            // At the same time, re-read the properties we're interested in.
            testFile = (CcFile) testFile.doVersionControl(wantedProps);
        }

        if ( ! testFile.getIsCheckedOut()) {
            // The file is not yet checked out, so check it out.
            // At the same time, re-read the properties we're interested in.
            testFile = testFile.doCcCheckout(null, wantedProps);
        }

        // Verify that the file is now version controlled and checked out.
        assert(testFile.getIsVersionControlled() == true);
        assert(testFile.getIsCheckedOut() == true);

Es posible que determinadas operaciones de recursos de una vista web local interactúen, o no, con un servidor. Por ejemplo:

La interfaz de recurso en sí no proporciona ningún método para crear el recurso subyacente, porque algunos recursos no pueden ser creados por el usuario. Tenga en cuenta la distinción entre crear el proxy, que es una cuestión de crear una instancia de un objeto Resource, y crear el recurso. Esta última acción debe realizarse llamando al método doCreateResource() o doCreateVersionControlledResource().


Comentarios