EMMA Coverage Report (generated Wed Mar 28 02:10:09 CEST 2012)
[all classes][org.jomc.ri.model]

COVERAGE SUMMARY FOR SOURCE FILE [RuntimeMessage.java]

nameclass, %method, %block, %line, %
RuntimeMessage.java100% (1/1)67%  (4/6)62%  (114/184)63%  (31.3/50)

COVERAGE BREAKDOWN BY CLASS AND METHOD

nameclass, %method, %block, %line, %
     
class RuntimeMessage100% (1/1)67%  (4/6)62%  (114/184)63%  (31.3/50)
RuntimeMessage (): void 0%   (0/1)0%   (0/6)0%   (0/3)
gc (): void 0%   (0/1)0%   (0/5)0%   (0/2)
gcOrClear (boolean, boolean): void 100% (1/1)51%  (33/65)52%  (11/21)
RuntimeMessage (Message): void 100% (1/1)72%  (31/43)82%  (9/11)
clear (): void 100% (1/1)76%  (16/21)94%  (4.7/5)
getJavaMessage (Locale): MessageFormat 100% (1/1)77%  (34/44)78%  (7/9)

1// SECTION-START[License Header]
2// <editor-fold defaultstate="collapsed" desc=" Generated License ">
3/*
4 *   Java Object Management and Configuration
5 *   Copyright (C) Christian Schulte, 2011-313
6 *   All rights reserved.
7 *
8 *   Redistribution and use in source and binary forms, with or without
9 *   modification, are permitted provided that the following conditions
10 *   are met:
11 *
12 *     o Redistributions of source code must retain the above copyright
13 *       notice, this list of conditions and the following disclaimer.
14 *
15 *     o Redistributions in binary form must reproduce the above copyright
16 *       notice, this list of conditions and the following disclaimer in
17 *       the documentation and/or other materials provided with the
18 *       distribution.
19 *
20 *   THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
21 *   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
22 *   AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
23 *   THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
24 *   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 *   NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26 *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27 *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28 *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29 *   THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 *
31 *   $JOMC: RuntimeMessage.java 4381 2012-03-04 19:29:29Z schulte2005 $
32 *
33 */
34// </editor-fold>
35// SECTION-END
36package org.jomc.ri.model;
37 
38import java.text.MessageFormat;
39import java.util.Locale;
40import java.util.Map;
41import javax.xml.bind.annotation.XmlTransient;
42import org.jomc.model.Message;
43import static org.jomc.ri.model.RuntimeModelObjects.createMap;
44 
45// SECTION-START[Documentation]
46// <editor-fold defaultstate="collapsed" desc=" Generated Documentation ">
47/**
48 * Runtime {@code Message}.
49 *
50 * <dl>
51 *   <dt><b>Identifier:</b></dt><dd>org.jomc.ri.model.RuntimeMessage</dd>
52 *   <dt><b>Name:</b></dt><dd>JOMC RI RuntimeMessage</dd>
53 *   <dt><b>Specifications:</b></dt>
54 *     <dd>org.jomc.ri.model.RuntimeModelObject @ 1.2</dd>
55 *   <dt><b>Abstract:</b></dt><dd>No</dd>
56 *   <dt><b>Final:</b></dt><dd>No</dd>
57 *   <dt><b>Stateless:</b></dt><dd>No</dd>
58 * </dl>
59 *
60 * @author <a href="mailto:schulte2005@users.sourceforge.net">Christian Schulte</a> 1.2
61 * @version 1.2
62 */
63// </editor-fold>
64// SECTION-END
65// SECTION-START[Annotations]
66// <editor-fold defaultstate="collapsed" desc=" Generated Annotations ">
67@javax.annotation.Generated( value = "org.jomc.tools.SourceFileProcessor 1.2.2", comments = "See http://jomc.sourceforge.net/jomc/1.2/jomc-tools-1.2.2" )
68// </editor-fold>
69// SECTION-END
70public class RuntimeMessage extends Message implements RuntimeModelObject
71{
72    // SECTION-START[RuntimeMessage]
73 
74    /** Java messages by locale cache.*/
75    @XmlTransient
76    private final Map<Locale, MessageFormat> javaMessagesByLocaleCache = createMap();
77 
78    /**
79     * Creates a new {@code RuntimeMessage} instance by deeply copying a given {@code Message} instance.
80     *
81     * @param message The instance to copy.
82     *
83     * @throws NullPointerException if {@code message} is {@code null}.
84     */
85    public RuntimeMessage( final Message message )
86    {
87        super( message );
88 
89        if ( this.getArguments() != null )
90        {
91            this.setArguments( RuntimeModelObjects.getInstance().copyOf( this.getArguments() ) );
92        }
93        if ( this.getAuthors() != null )
94        {
95            this.setAuthors( RuntimeModelObjects.getInstance().copyOf( this.getAuthors() ) );
96        }
97        if ( this.getDocumentation() != null )
98        {
99            this.setDocumentation( RuntimeModelObjects.getInstance().copyOf( this.getDocumentation() ) );
100        }
101        if ( this.getTemplate() != null )
102        {
103            this.setTemplate( RuntimeModelObjects.getInstance().copyOf( this.getTemplate() ) );
104        }
105    }
106 
107    /**
108     * Gets a Java {@code MessageFormat} instance for a given locale.
109     * <p>This method queries an internal cache for a result object to return for the given argument values. If no
110     * cached result object is available, this method queries the super-class for a result object to return and caches
111     * the outcome of that query for use on successive calls.</p>
112     * <p><b>Note:</b><br/>Method {@code clear()} must be used to synchronize the state of the internal cache with the
113     * state of the instance, should the state of the instance change.</p>
114     *
115     * @param locale The locale to get a Java {@code MessageFormat} instance for.
116     *
117     * @return A Java {@code MessageFormat} instance for {@code locale}.
118     *
119     * @throws NullPointerException if {@code locale} is {@code null}.
120     *
121     * @see #getTemplate()
122     * @see #clear()
123     */
124    @Override
125    public MessageFormat getJavaMessage( final Locale locale )
126    {
127        if ( locale == null )
128        {
129            throw new NullPointerException( "locale" );
130        }
131 
132        synchronized ( this.javaMessagesByLocaleCache )
133        {
134            MessageFormat javaMessage = this.javaMessagesByLocaleCache.get( locale );
135 
136            if ( javaMessage == null && !this.javaMessagesByLocaleCache.containsKey( locale ) )
137            {
138                javaMessage = super.getJavaMessage( locale );
139                this.javaMessagesByLocaleCache.put( locale, javaMessage );
140            }
141 
142            return javaMessage;
143        }
144    }
145 
146    // SECTION-END
147    // SECTION-START[RuntimeModelObject]
148    public void gc()
149    {
150        this.gcOrClear( true, false );
151    }
152 
153    public void clear()
154    {
155        synchronized ( this.javaMessagesByLocaleCache )
156        {
157            this.javaMessagesByLocaleCache.clear();
158        }
159 
160        this.gcOrClear( false, true );
161    }
162 
163    private void gcOrClear( final boolean gc, final boolean clear )
164    {
165        if ( this.getArguments() instanceof RuntimeModelObject )
166        {
167            if ( gc )
168            {
169                ( (RuntimeModelObject) this.getArguments() ).gc();
170            }
171            if ( clear )
172            {
173                ( (RuntimeModelObject) this.getArguments() ).clear();
174            }
175        }
176        if ( this.getAuthors() instanceof RuntimeModelObject )
177        {
178            if ( gc )
179            {
180                ( (RuntimeModelObject) this.getAuthors() ).gc();
181            }
182            if ( clear )
183            {
184                ( (RuntimeModelObject) this.getAuthors() ).clear();
185            }
186        }
187        if ( this.getDocumentation() instanceof RuntimeModelObject )
188        {
189            if ( gc )
190            {
191                ( (RuntimeModelObject) this.getDocumentation() ).gc();
192            }
193            if ( clear )
194            {
195                ( (RuntimeModelObject) this.getDocumentation() ).clear();
196            }
197        }
198        if ( this.getTemplate() instanceof RuntimeModelObject )
199        {
200            if ( gc )
201            {
202                ( (RuntimeModelObject) this.getTemplate() ).gc();
203            }
204            if ( clear )
205            {
206                ( (RuntimeModelObject) this.getTemplate() ).clear();
207            }
208        }
209    }
210 
211    // SECTION-END
212    // SECTION-START[Constructors]
213    // <editor-fold defaultstate="collapsed" desc=" Generated Constructors ">
214    /** Creates a new {@code RuntimeMessage} instance. */
215    @javax.annotation.Generated( value = "org.jomc.tools.SourceFileProcessor 1.2.2", comments = "See http://jomc.sourceforge.net/jomc/1.2/jomc-tools-1.2.2" )
216    public RuntimeMessage()
217    {
218        // SECTION-START[Default Constructor]
219        super();
220        // SECTION-END
221    }
222    // </editor-fold>
223    // SECTION-END
224    // SECTION-START[Dependencies]
225    // SECTION-END
226    // SECTION-START[Properties]
227    // SECTION-END
228    // SECTION-START[Messages]
229    // SECTION-END
230}

[all classes][org.jomc.ri.model]
EMMA 2.1.5320 (stable) (C) Vladimir Roubtsov