at.gv.egiz.pdfas.api.commons
Interface DynamicSignatureProfile

All Known Implementing Classes:
DynamicSignatureProfileImpl

public interface DynamicSignatureProfile

A dynamic signature profile. It is used to define a signature profile like the ones from pdf-as/config.properties at runtime. After creation via PdfAs you can set properties via setPropertyRaw(String, String) or setFieldValue(String, String).
You have to call apply() to use the profile. The identifying name (e.g. for SignParameters.setSignatureProfileId(String) can be obtained via getName().
Depending on the DynamicSignatureLifetimeEnum the profile can be alive and usable till you dispose() it manually.

Sample usage:

      SignParameters sp = new SignParameters();
      . . .           
      sp.setSignatureType(Constants.SIGNATURE_TYPE_TEXTUAL);
      sp.setSignatureDevice(Constants.SIGNATURE_DEVICE_MOA);

      // create a new dynamic profile based on SIGNATURBLOCK_DE (every property is copied) with manual lifetime
      DynamicSignatureProfile dsp = pdfAs.createDynamicSignatureProfile("myUniqueName", "SIGNATURBLOCK_DE", 
            DynamicSignatureLifetimeEnum.MANUAL);  

      // set something
      dsp.setPropertyRaw("key.SIG_META", "Statement");
      dsp.setPropertyRaw("value.SIG_META", "respect to the man in the icecream van ${subject.EMAIL}");
      dsp.setPropertyRaw("value.SIG_LABEL", "./images/signatur-logo_en.png");
      dsp.setPropertyRaw("table.main.Style.halign", "right");

      // mandatory: apply the profile, you have to apply again after changes (overriding your previous setting)
      dsp.apply();                 
      sp.setSignatureProfileId(dsp.getName());            

      // execute PDF-AS
      pdfAs.sign(sp);              

      . . .

     // your profile is saved and you can obtain it again anytime later:
      dsp = pdfAs.loadDynamicSignatureProfile("myUniqueName");
      // use it for another sign.
      // dont forget to dispose() sometimes because it was manual lifetime
      System.out.println(dsp.getName());
  

Author:
exthex

Method Summary
 void apply()
          Apply the signature profile.
 void dispose()
          Disposes the signature profile from the global store.
 String getFieldValue(String fieldName)
          Get a field value from the profile.
 String getName()
          Get the name of the dynamic signature profile.
 String getPropertyRaw(String key)
          Get any property from the signature profile.
 void setFieldValue(String fieldName, String value)
          Set a field value for the profile.
 void setPropertyRaw(String key, String val)
          Set any property for the signature profile.
 

Method Detail

getName

String getName()
Get the name of the dynamic signature profile. Equals the SignatureProfileId

Returns:

setFieldValue

void setFieldValue(String fieldName,
                   String value)
Set a field value for the profile. Use setPropertyRaw(String, String) for setting any property.
For example to set sig_obj.MEIN_DYN_SIGNATURBLOCK.value.SIG_META just use SIG_META as fieldName.

Parameters:
fieldName - the name of the field
value - the value to set

getFieldValue

String getFieldValue(String fieldName)
Get a field value from the profile. See setFieldValue(String, String)

Parameters:
fieldName -
Returns:

setPropertyRaw

void setPropertyRaw(String key,
                    String val)
Set any property for the signature profile. Uses the same keys as the property file without the "prefix" for the profile. For example to set sig_obj.MEIN_DYN_SIGNATURBLOCK.key.SIG_META use key.SIG_META

Parameters:
key - property key
val - property value

getPropertyRaw

String getPropertyRaw(String key)
Get any property from the signature profile. See setPropertyRaw(String, String) for details.

Parameters:
key -
Returns:

apply

void apply()
Apply the signature profile. Call this after all properties are set and you want to use the profile. It is then added to the globally available signature profiles. Depending on the lifetime model DynamicSignatureLifetimeEnum you have to dispose() it manually when not needed anymore.


dispose

void dispose()
Disposes the signature profile from the global store. Call this for DynamicSignatureLifetimeEnum.MANUAL only.



Copyright © 2006-2011. All Rights Reserved.