com.groiss.wfxml
Class WfXMLWebLink

java.lang.Object
  extended by com.groiss.wfxml.WfXMLObject
      extended by com.groiss.wfxml.WfXMLWebLink
All Implemented Interfaces:
java.lang.Cloneable

public class WfXMLWebLink
extends WfXMLObject
implements java.lang.Cloneable

Instances of this class represent web links. You can use it to create new web links, create web links out of JDOM elements, and create a web link out of an existing DMSWebLink object.
See the super class WfXMLObject for details and examples.


Field Summary
 
Fields inherited from class com.groiss.wfxml.WfXMLObject
namespace, notes, userId
 
Constructor Summary
WfXMLWebLink(DMSWebLink dmsWebLink)
          Use this constructor to build a WfXMLWebLink out of a DMSWebLink.
WfXMLWebLink(org.jdom.Element webLinkElem)
          Deprecated. 
WfXMLWebLink(java.lang.String name, java.lang.String url, java.lang.String description, java.lang.String userId)
          Creates a web link with all possible fields.
WfXMLWebLink(org.apache.xmlbeans.XmlObject obj)
           
 
Method Summary
 java.lang.Object clone()
          Creates a deep copy of this web link.
 DMSObject createDMSObject(User defaultCreator)
          Creates a DMSWebLink object out of this WfXMLWebLink.
 void fill(DMSObject existingWebLink, User defaultCreator)
          This method fills an existing DMSWebLink with the data of this WfXMLWebLink and updates it to the database.
 org.jdom.Element getAsXML()
          This method creates a JDOM representation of this web link.
 java.lang.String getDescription()
          Returns the description of this web link.
 java.lang.String getName()
          Returns the name string of this web link.
 java.lang.String getURL()
          Returns the URL (as String) of this web link.
 org.apache.xmlbeans.XmlObject getXMLObject()
           
 void setDescription(java.lang.String description)
          Set a new description for this web link.
 void setName(java.lang.String name)
          Set the name of this web link.
 void setURL(java.lang.String url)
          Set the URL for this web link.
 
Methods inherited from class com.groiss.wfxml.WfXMLObject
createInstance, createInstance, createInstance, getUser, getUser, getUserId, setUserId
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WfXMLWebLink

public WfXMLWebLink(java.lang.String name,
                    java.lang.String url,
                    java.lang.String description,
                    java.lang.String userId)
Creates a web link with all possible fields.

Parameters:
name - A subject for the note.
url - The content of the note.
description - A description text for the web link. A description is not obligatory, so you can provide null if you don't want to set something special.
userId - Id of the user who will be (or is) the creator of the note. You can use null here, if you don't want to use a special user. In that case the note will be created by another user (if possible), or an error will occur.

WfXMLWebLink

public WfXMLWebLink(org.apache.xmlbeans.XmlObject obj)

WfXMLWebLink

@Deprecated
public WfXMLWebLink(org.jdom.Element webLinkElem)
             throws java.lang.IllegalArgumentException
Deprecated. 

Creates a web link out of a JDOM Element. The Element must be a web link element, otherwise an exception will be thrown.

Parameters:
webLinkElem - JDOM Element representing a web link.
Throws:
java.lang.IllegalArgumentException - if the webLinkElem parameter is no valid note element.

WfXMLWebLink

public WfXMLWebLink(DMSWebLink dmsWebLink)
             throws java.lang.Exception
Use this constructor to build a WfXMLWebLink out of a DMSWebLink. The WfXMLWebLink will be filled with the values of the DMSWebLink.

Parameters:
dmsWebLink - A DMSWebLink object.
Throws:
java.lang.Exception - if there occur problems reading data from the DMSWebLink object.
Method Detail

getName

public java.lang.String getName()
Returns the name string of this web link.

Specified by:
getName in class WfXMLObject
Returns:
A String containing the name of this web link or null if no name has been defined.

getURL

public java.lang.String getURL()
Returns the URL (as String) of this web link.

Returns:
A String with the URL of this web link or null if no URL has been set.

getDescription

public java.lang.String getDescription()
Returns the description of this web link.

Returns:
A String holding the description of this web link or null if no description has been defined.

setName

public void setName(java.lang.String name)
Set the name of this web link.

Parameters:
name - A String containing a new name for this web link.

setURL

public void setURL(java.lang.String url)
Set the URL for this web link. You should provide a complete URL here (like "http://www...") so that the link will work properly in @enterprise.

Parameters:
url - A String with the new URL for the web link

setDescription

public void setDescription(java.lang.String description)
Set a new description for this web link.

Parameters:
description - A String holding the new description.

fill

public void fill(DMSObject existingWebLink,
                 User defaultCreator)
          throws java.lang.Exception
This method fills an existing DMSWebLink with the data of this WfXMLWebLink and updates it to the database.

Specified by:
fill in class WfXMLObject
Parameters:
existingWebLink - The existing DMSWebLink. If you pass an object that is no DMSWebLink, this method will simply do nothing.
defaultCreator - A creator for objects that must be created. As this method updates a web link, the user will not be used, because it will not be necessary to create anything here. You can simply pass in null.
Throws:
java.lang.Exception - If updating the DMSWebLink with the data fails.

createDMSObject

public DMSObject createDMSObject(User defaultCreator)
Creates a DMSWebLink object out of this WfXMLWebLink.

Specified by:
createDMSObject in class WfXMLObject
Parameters:
defaultCreator - You can specify a default creator with this parameter. If there is no user defined in this WfXMLWebLink object, or if the defined user cannot be found, the defaultCreator will be used. If this user also does not exist, an ApplicationException will be thrown.
Returns:
The new DMSWebLink object, or null if creating the web link didn't work.
Throws:
java.lang.Exception - if no user was found for creating the web link, or creating failed.

getAsXML

public org.jdom.Element getAsXML()
This method creates a JDOM representation of this web link.

Specified by:
getAsXML in class WfXMLObject
Returns:
A JDOM Element, which is a web link element with all information of this web link.

clone

public java.lang.Object clone()
Creates a deep copy of this web link. The returned object can be casted to WfXMLWebLink.

Overrides:
clone in class java.lang.Object

getXMLObject

public org.apache.xmlbeans.XmlObject getXMLObject()
Specified by:
getXMLObject in class WfXMLObject


@enterprise 8.0.22989 Copyright © 2001-2017 Groiss Informatics GmbH. All Rights Reserved.