Interface IExportDelegator

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> getExportRecords​(boolean useJournal, long maxRecs, int sourceNum, long offset, boolean format, java.lang.String journalPrefix, java.lang.String filter)
      Get a list of exported journal or checkpoint records (admin / superuser command).
      java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> getExportRecords​(ExportRecordsOptions opts)
      Get a list of exported journal or checkpoint records (admin / superuser command).
      void getStreamingExportRecords​(ExportRecordsOptions opts, IStreamingCallback callback, int key)
      Get each exported journal or checkpoint record (admin / superuser command) as it comes in from the server, rather than waiting for the entire command to complete.
    • Method Detail

      • getExportRecords

        java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> getExportRecords​(boolean useJournal,
                                                                                                long maxRecs,
                                                                                                int sourceNum,
                                                                                                long offset,
                                                                                                boolean format,
                                                                                                java.lang.String journalPrefix,
                                                                                                java.lang.String filter)
                                                                                         throws ConnectionException,
                                                                                                RequestException,
                                                                                                AccessException
        Get a list of exported journal or checkpoint records (admin / superuser command).

        See the main p4 export command documentation for full semantics and usage details.

        Note that the 'skip*' options in ExportRecordsOptions are specific to P4Java only; they are not Perforce command options. These options are for field handling rules in the lower layers of P4Java. The field rules are for identifying the fields that should skip charset translation of their values; leaving their values as bytes instead of converting them to strings. Please see ExportRecordsOptions for usage details.

        Parameters:
        useJournal - *If true, specifies a journal number and optional offset position (journal number/offset) from which to start exporting. Corresponds to the '-j token' flag.

        If false, specifies a checkpoint number and optional offset position (checkpoint number#offset) from which to start exporting. Corresponds to the '-c token' flag.

        maxRecs - If greater than zero, limits the number of lines (records) exported. Corresponds to the '-l lines' flag.
        sourceNum - If positive, specifies a journal or checkpoint number. Corresponds to the 'token' part of the '-j token' and '-c token' flags.

        The '-j token' flag specifies a journal number and optional position (in the form: journal number/offset) from which to start exporting. The -c token flag specifies a checkpoint number and optional position (in the form: checkpoint number#offset) from which to start exporting.

        offset - If positive, specifies a journal or checkpoint optional offset position (journal number/offset or checkpoint number#offset) from which to start exporting.
        format - If true, formats non-textual datatypes appropriately. Corresponds to the '-f' flag.
        journalPrefix - If non-null, specifies a file name prefix to match the one used with 'p4d -jc prefix'. Corresponds to the '-J' flag.
        filter - If non-null, limits output to records that match the filter pattern. Corresponds to the '-F' flag.
        Returns:
        export records list
        Throws:
        ConnectionException - on error
        RequestException - on error
        AccessException - on error
      • getExportRecords

        java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> getExportRecords​(ExportRecordsOptions opts)
                                                                                         throws P4JavaException
        Get a list of exported journal or checkpoint records (admin / superuser command).

        See the main p4 export command documentation for full semantics and usage details.

        Note that the 'skip*' options in ExportRecordsOptions are specific to P4Java only; they are not Perforce command options. These options are for field handling rules in the lower layers of P4Java. The field rules are for identifying the fields that should skip charset translation of their values; leaving their values as bytes instead of converting them to strings. Please see ExportRecordsOptions for usage details.

        Parameters:
        opts - ExportRecordsOptions object describing optional parameters; if null, no options are set.
        Returns:
        non-null but possibly empty list of maps representing exported journal or checkpoint records.
        Throws:
        P4JavaException - if an error occurs processing this method and its parameters.
      • getStreamingExportRecords

        void getStreamingExportRecords​(ExportRecordsOptions opts,
                                       @Nonnull
                                       IStreamingCallback callback,
                                       int key)
                                throws P4JavaException
        Get each exported journal or checkpoint record (admin / superuser command) as it comes in from the server, rather than waiting for the entire command to complete.

        The results are sent to the user using the IStreamingCallback handleResult method; see the IStreamingCallback Javadoc for details. The payload passed to handleResult is usually the raw map gathered together deep in the RPC protocol layer, and the user is assumed to have the knowledge and technology to be able to parse it and use it suitably in much the same way as a user unpacks or processes the results from the other low-level exec methods like execMapCommand.

        See the main p4 export command documentation for full semantics and usage details.

        Note that the 'skip*' options in ExportRecordsOptions are specific to P4Java only; they are not Perforce command options. These options are for field handling rules in the lower layers of P4Java. The field rules are for identifying the fields that should skip charset translation of their values; leaving their values as bytes instead of converting them to strings. Please see ExportRecordsOptions for usage details.

        Parameters:
        opts - ExportRecordsOptions object describing optional parameters; if null, no options are set.
        callback - a non-null IStreamingCallback to be used to process the incoming results.
        key - an opaque integer key that is passed to the IStreamingCallback callback methods to identify the action as being associated with this specific call.
        Throws:
        P4JavaException - if an error occurs processing this method and its parameters.
        Since:
        2012.3