Package de.svws_nrw.davapi.util.vcard

Klasse VCard

java.lang.Object
de.svws_nrw.davapi.util.vcard.VCard
public class VCard extends Object
Diese Klasse repräsentiert eine VCard und bietet Methoden, Eigenschaften hinzuzufügen, zu lesen sowie die VCard zu serialisieren.

  • Konstruktordetails

    • VCard

      public VCard(FullnameProperty fnProperty)
      Konstruktor für eine VCard mit einem gegebenen Fullname Property Dies erfüllt die Minimalen Anforderungen zum Serialisieren einer VCard
      Parameter:
      fnProperty - das Fullname Property der VCard

    • VCard

      public VCard(NameProperty nameProperty)
      Konstruktor für eine VCard mit einem gegebenen Name Property. Das benötigte FullnameProperty wird daraus erzeugt
      Parameter:
      nameProperty - das nameProperty der VCard

  • Methodendetails

    • stringToUUId

      public static String stringToUUId(String input)
      Hilfsmethode um aus einem gegebenen String eine GUID zu erzeugen, dazu wird UUID.nameUUIDFromBytes(byte[]) verwendet
      Parameter:
      input - der String, dessen GUID-HASH erzeugt werden soll
      Gibt zurück:
      ein GUID-Hash der eingabe

    • serialize

      public String serialize()
      Methode zum Serialisieren dieser VCard
      Gibt zurück:
      die VCard als Zeichenkette

    • addProperty

      public void addProperty(VCardProperty property)
      Methode zum hinzufügen eines VCardProperty
      Parameter:
      property - das zuzufügende Property

    • getProperty

      public Optional<VCardProperty> getProperty(String type)
      Methode zum Lesen eines VCardProperty
      Parameter:
      type - der Type, der gesucht werden soll
      Gibt zurück:
      das Property, wenn es bei dem gegebenen Typ bereits eines gibt

    • setKind

      public void setKind(@NotNull @NotNull VCard.Kind k)
      setzt die Art der VCard, nur für VCard Version 4.0 nützlich
      Parameter:
      k - die Art der VCard

    • setUID

      public void setUID(String uid)
      setzt die UID der VCard. Nützlich aber nicht nötig, ist stringToUUId(String) aufzurufen, um den angegeben String vorher ins GUID-Format zu bringen.
      Parameter:
      uid - die UID

    • addMember

      public void addMember(String uid)
      fügt ein Mitglied zu dieser VCard hinzu
      Parameter:
      uid - die UID der VCard

    • setVersion

      public void setVersion(@NotNull @NotNull VCard.Version version)
      setzt die Version der VCard
      Parameter:
      version - die Version

    • createVCard

      public static VCard createVCard(AdressbuchEintrag eintrag)
      Statische Methode zum erstellen einer VCard auf Basis eines AdressbuchEintrags.
      Parameter:
      eintrag - der AdressbuchEintrag
      Gibt zurück:
      die VCard, die diesen Adressbucheintrag repräsentiert.