https://oomodels.org/index.php?action=history&feed=atom&title=Artefact%3ATemplate%2Forg%2Foogenerator%2Fexamples%2Ftutorial%2FExample0100_EncodingArtefact:Template/org/oogenerator/examples/tutorial/Example0100 Encoding - Revision history2026-04-29T09:23:36ZRevision history for this page on the wikiMediaWiki 1.37.1https://oomodels.org/index.php?title=Artefact:Template/org/oogenerator/examples/tutorial/Example0100_Encoding&diff=1572&oldid=prevAndreasLeue: New page: {{Metabox | Meta_Type = Type:org/oogenerator/Template/2.0 | Meta_Domain = Domain:it/development/formatting | Meta_Category = Type:org/oomodels/wiki/Template | Meta_Download = true | ...2008-07-25T14:55:50Z<p>New page: {{Metabox | Meta_Type = Type:org/oogenerator/Template/2.0 | Meta_Domain = Domain:it/development/formatting | Meta_Category = Type:org/oomodels/wiki/Template | Meta_Download = true | ...</p>
<p><b>New page</b></p><div>{{Metabox<br />
| Meta_Type = Type:org/oogenerator/Template/2.0<br />
| Meta_Domain = Domain:it/development/formatting<br />
| Meta_Category = Type:org/oomodels/wiki/Template<br />
| Meta_Download = true<br />
| Meta_Maturity = final<br />
}}<br />
<br />
{{AutoUpload}}<br />
<br />
==Code==<br />
<br />
<div class="code"><br />
<span class="oogintro">G-2.0-plain_java-1.0</span><br />
<span class="oogcomment">⊰<br />
Templates produce output. Such output might be just plain<br />
ASCII, plain Unicode or might be encoded somehow, say HTML.<br />
<br />
Furthermore, templates process input, which may or may not<br />
be written in the same encoding.<br />
<br />
And finally, the normal template text might have a third<br />
encoding.<br />
<br />
Let's assume you want to create a Java properties file<br />
based on XML input. Then<br />
<br />
- in the input we have '&lt;', '&gt;' and '&amp;'.<br />
- in our template text we just want to write normal Unicode.<br />
- in the properties file everything non-ASCII (e.g. german<br />
umlauts) must be escaped '\uXXXX'<br />
<br />
In templates, such a situation is rather the rule then<br />
an exception.<br />
<br />
Instead of writing conversion calls each and everyplace,<br />
we just can use the recoding operator '<span class="oogencoding">⌘'</span>:<br />
⊱</span><span class="oogcontinuation">…</span><br />
<span class="oogcode">« String xml_input = " immer und überall gilt: 17 &lt; 23 "; »</span><span class="oogcontinuation">…</span><br />
<br />
<span class="oogexpression">◂xml_input<span class="oogencoding">⌘XML/JAVAPROP</span>▸</span><br />
<br />
<span class="oogcomment">⊰<br />
You get the output<br />
<br />
" immer und \u00FCberall gilt: 17 < 23 "<br />
<br />
The '<span class="oogencoding">⌘</span>...' sequence is called a 'recoding'.<br />
It consists of a sequence of encoding names. The above<br />
example reads 'convert XML to JAVAPROP'.<br />
<br />
The encoding names are defined in an enumeration class<br />
named 'Encoding'. You can use this class also from normal<br />
Java code.<br />
<br />
If we have many such expressions in our template, we can<br />
define a default recoding:<br />
⊱</span><span class="oogcontinuation">…</span><br />
<SPAN CLASS="OOGTEMPLATECODE">⊏ <span class="oogencoding">⌘XML/JAVAPROP</span> ⊐</SPAN><span class="oogcontinuation">…</span><br />
<br />
<span class="oogexpression">◂xml_input▸</span><br />
<br />
<span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogcomment">⊰<br />
This yields the same result as above.<br />
<br />
Default encodings can be nested (they apply to included<br />
and subtemplates, too, but we do not know yet what these are).<br />
⊱</span><span class="oogcontinuation">…</span><br />
<SPAN CLASS="OOGTEMPLATECODE">⊏ <span class="oogencoding">⌘DOCBOOK/JAVAPROP</span> ⊐</SPAN><span class="oogcontinuation">…</span><br />
<span class="oogindentation"> ⋮</span><SPAN CLASS="OOGTEMPLATECODE">⊏ <span class="oogencoding">⌘XML/JAVAPROP</span> ⊐</SPAN><span class="oogcontinuation">…</span><br />
<br />
<span class="oogexpression">◂xml_input▸</span><br />
<br />
<span class="oogindentation"> ⋮</span><span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogcomment">⊰<br />
This again yields the same result as above.<br />
<br />
Encodings need not be complete, they will be combined.<br />
⊱</span><span class="oogcontinuation">…</span><br />
<SPAN CLASS="OOGTEMPLATECODE">⊏ <span class="oogencoding">⌘XML/</span> ⊐</SPAN><span class="oogcontinuation">…</span><br />
<br />
<span class="oogexpression">◂xml_input<span class="oogencoding">⌘/JAVAPROP</span>▸</span><br />
<br />
<span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogcomment">⊰<br />
This again yields the same result as above.<br />
<br />
Note, that a default encoding applies to embedded Java expressions<br />
as well as normal template text. What if they are different, as<br />
within our example?<br />
<br />
Then you can apply a different default encoding to these<br />
categories.<br />
⊱</span><span class="oogcontinuation">…</span><br />
<span class="oogtemplatecode">⊏ <span class="oogencoding">⌘</span>[x]XML/JAVAPROP ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogtemplatecode">⊏ <span class="oogencoding">⌘</span>[t]UTF8/JAVAPROP ⊐</span><span class="oogcontinuation">…</span><br />
<br />
<span class="oogexpression">◂xml_input▸</span><br />
<br />
This '&lt;' is not translated, since we're here in normal<br />
template text, not in an expression.<br />
<br />
<span class="oogexpression">◂"But this '&lt;' is translated, since we're an expression"▸</span><br />
<br />
<span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogtemplatecode">⊏ /<span class="oogencoding">⌘</span> ⊐</span><span class="oogcontinuation">…</span><br />
<span class="oogcomment">⊰<br />
As you might have guessed, 'x' stands for 'expression' and<br />
't' for 'template text'.<br />
⊱</span><span class="oogcontinuation">…</span><br />
</div></div>AndreasLeue