Public:BWmeta service/Java mapping

From YaddaWiki

Revision as of 13:24, 6 October 2010 (view source) Bolo (Talk | contribs) m (→YAttribute) ← Older edit		Revision as of 14:08, 11 October 2010 (view source) Bolo (Talk | contribs) (→Rich text support) Newer edit →
Line 48:		Line 48:
	=== Changes in <code>YRichText</code> ===		=== Changes in <code>YRichText</code> ===
-	<code>YRichText</code> is immutable.	+	<!-- <code>YRichText</code> is immutable. -->
	==== Constructors ====		==== Constructors ====

---

Revision as of 14:08, 11 October 2010

Service details
Name	BWmeta
Code location (relative to SVN root)	projects/dir/bwmeta-core
Javadoc
Contact person	Jakub Jurkiewicz
edit BWmeta format Data Model BWMeta Model Design principles 1.0.5 example 1.2.0 example 2.0.0 example Feature requests Linked Open Data Hierarchys Book Journal BWmeta usage in YADDA Java mapping Rich text in Java mapping Transformers data sources Conventions and constants Contents and attachments Internationalization Tutorial How to convert to Dublic Core? Categorizations

Contents 1 History 2 General contracts 3 Rich text support 3.1 Changes in YRichText 3.1.1 Constructors 3.1.2 Methods 3.2 Changes in classes with a YRichText property 3.2.1 YName, YDescription 3.2.2 YAttribute 3.2.3 YTagList

History

Three different mappings of BWmeta to Java have been written in the project's lifetime. The following table summarizes the mappings.

Model Name	Works with BWmeta versions	Usage areas	Comments
Repo model	1.0.0 ÷ 1.0.5	Processes, YaddaWeb	Hibernate-oriented
DeskLight model	1.0.0 ÷ 1.0.5	DeskLight
"Y" model	1.2.0 ÷ 2.0.0	Pack Management

Current efforts are focused on replacing the older models (Repo and DeskLight) with the latest one ("Y"). The remainder of this page and all the other pages on BWmeta usage in YADDA assume usage of the "Y" model.

General contracts

Unless explicitly stated in the documentation, every "Y" class has the following properties:

• has a public default constructor.
• every property is protected, but has a public getter and setter.
• getters of String, YLanguage and List properties can never return null. Instead, an empty String, YLanguage.Undetermined or an empty List is returned, respectively.
• for every List<T> property:
  • its getter returns a modifiable List<T>;
  • its getter returns the same reference all the time;
  • its setter accepts any Collection<T> (and copies the contents);
  • there's an adder (which returns this).
• every setter and every list adder returns this, which allows chained setting, e.g.:

new YElement()
    .setId("bwmeta1.element.foo")
    .addName(new YName().setText("Foo").setLanguage(YLanguage.English))
    .addDescription(new YDescription().setText("Lorem ipsum").setLanguage(YLanguage.Latin));

The folowing contracts are to be implemented/verified in the future:

• hashCode() and equals() methods are based on the values of all the properties, i.e., two "Y" objects are equal iff they are of the same type and all their properties are equal.

Rich text support

Support for rich text, introduced in BWmeta 2.0.0 calls for changes in the "Y" model.

Changes in YRichText

Constructors

• YRichText(String) – constructor from plain text.
• YRichText(List<YRichText.Part>) – constructor from list of trees.

Methods

• String toXmlFragment() – returns an XML Fragment representation of the rich text.
• String toText() – returns a plain text view of the rich text. It's a concatenation of text contents of the tree list visited in the infix order.
• List<YRichText.Part> toParts() – returns a list of trees which represent the rich text.

Changes in classes with a YRichText property

YRichText-related methods (other than the ones below) which have been already added should be @Deprecated and subsequently removed.

YName, YDescription

• Every constructor from String text has a corresponding constructor from YRichText text.
• String getText() – returns plain text.
• YRichText getRichText() – returns rich text.
• T setText(String) – sets plain text.
• T setRichText(YRichText) – sets rich text.

YAttribute

• Every constructor from String value has a corresponding constructor from YRichText value.
• String getValue() – returns plain text.
• YRichText getRichValue() – returns rich text.
• YAttribute setValue(String) – sets plain text.
• YAttribute setRichValue(YRichText) – sets rich text.

YTagList

• List<String> getValues() – returns unmodifiable, plain text view of the list of tags.
• List<YRichText> getRichValues() – returns modifiable, rich text view of the list of tags.
• YTagList setValues(Collection<String>) – sets plain text values.
• YTagList setRichValues(Collection<YRichText>) – sets rich text values.
• YTagList addValue(String) – adds a plain text value.
• YTagList addRichValue(YRichText) – adds a rich text value.