/usr/share/doc/libognl-java/LanguageGuide/specialCollectionsProperties.html is in libognl-java-doc 2.7.3-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 | <html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Pseudo-Properties for Collections</title><link href="../docbook.css" type="text/css" rel="stylesheet"><meta content="DocBook XSL Stylesheets V1.78.1" name="generator"><link rel="home" href="index.html" title="OGNL Language Guide"><link rel="up" href="basicExpressions.html" title="Chapter 4. Expressions"><link rel="prev" href="lambdaExpressions.html" title="Pseudo-Lambda Expressions"><link rel="next" href="differences.html" title="Operators that differ from Java's operators"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Pseudo-Properties for Collections</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="lambdaExpressions.html"><img src="../images/navigation/prev.gif" alt="Prev"></a> </td><th align="center" width="60%">Chapter 4. Expressions</th><td align="right" width="20%"> <a accesskey="n" href="differences.html"><img src="../images/navigation/next.gif" alt="Next"></a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="specialCollectionsProperties"></a>Pseudo-Properties for Collections</h2></div></div></div><p>There are some special properties of collections that <acronym class="acronym">OGNL</acronym> makes available. The reason for this is that the collections do not follow JavaBeans patterns for method naming; therefore the <code class="function">size()</code>,
<code class="function">length()</code>, etc. methods must be called instead of more intuitively referring to these as properties. <acronym class="acronym">OGNL</acronym> corrects this by exposing certain pseudo-properties as if they were built-in.</p><div class="table"><a name="N103F0"></a><p class="title"><b>Table 4.1. Special Collections Pseudo-Properties</b></p><div class="table-contents"><table summary="Special Collections Pseudo-Properties" border="1"><colgroup><col width="100"><col></colgroup><thead><tr><th valign="top">Collection</th><th valign="top">Special Properties</th></tr></thead><tbody><tr><td valign="top"><code class="classname">Collection</code> (inherited by <code class="classname">Map</code>, <code class="classname">List</code> & <code class="classname">Set</code>)</td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">size</code></span></dt><dd><p>The size of the collection</p></dd><dt><span class="term"><code class="literal">isEmpty</code></span></dt><dd><p>Evaluates
to <code class="constant">true</code> if the collection is empty</p></dd></dl></div></td></tr><tr><td valign="top">List</td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">iterator</code></span></dt><dd><p>Evalutes to an <code class="classname">Iterator</code> over the <code class="classname">List</code>.</p></dd></dl></div></td></tr><tr><td valign="top"><code class="classname">Map</code></td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">keys</code></span></dt><dd><p>Evalutes to a <code class="classname">Set</code> of all keys in the <code class="classname">Map</code>.</p></dd><dt><span class="term"><code class="literal">values</code></span></dt><dd><p>Evaluates
to a <code class="classname">Collection</code> of all values in the <code class="classname">Map</code>.</p></dd></dl></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Note]" src="../images/admon/note.gif"></td><th align="left">Note</th></tr><tr><td valign="top" align="left"><p>These properties, plus <code class="literal">size</code> and <code class="literal">isEmpty</code>,
are different than the indexed form of access for <code class="classname">Map</code>s (i.e. <code class="literal">someMap["size"]</code> gets the <code class="literal">"size"</code> key from the map, whereas <code class="literal">someMap.size</code>
gets the size of the <code class="classname">Map</code>.</p></td></tr></table></div></td></tr><tr><td valign="top"><code class="classname">Set</code></td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">iterator</code></span></dt><dd><p>Evalutes to an <code class="classname">Iterator</code> over the <code class="classname">Set</code>.</p></dd></dl></div></td></tr><tr><td valign="top"><code class="classname">Iterator</code></td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">next</code></span></dt><dd><p>Evalutes to the next object from the <code class="classname">Iterator</code>.</p></dd><dt><span class="term"><code class="literal">hasNext</code></span></dt><dd><p>Evaluates
to <code class="constant">true</code> if there is a next object available from the <code class="classname">Iterator</code>.</p></dd></dl></div></td></tr><tr><td valign="top"><code class="classname">Enumeration</code></td><td valign="top"><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a name="Enumeration.next"></a><code class="literal">next</code></span></dt><dd><p>Evalutes to the next object from the <code class="classname">Enumeration</code>.</p></dd><dt><span class="term"><a name="Enumeration.hasNext"></a><code class="literal">hasNext</code></span></dt><dd><p>Evaluates to <code class="constant">true</code> if there is a next object available from the <code class="classname">Enumeration</code>.</p></dd><dt><span class="term"><code class="literal">nextElement</code></span></dt><dd><p>Synonym
for <code class="literal"><a class="link" href="specialCollectionsProperties.html#Enumeration.next">next</a></code>.</p></dd><dt><span class="term"><code class="literal">hasMoreElements</code></span></dt><dd><p>Synonym for <code class="literal"><a class="link" href="specialCollectionsProperties.html#Enumeration.hasNext">hasNext</a></code>.</p></dd></dl></div></td></tr></tbody></table></div></div><br class="table-break"></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="lambdaExpressions.html"><img src="../images/navigation/prev.gif" alt="Prev"></a> </td><td align="center" width="20%"><a accesskey="u" href="basicExpressions.html"><img src="../images/navigation/up.gif" alt="Up"></a></td><td align="right" width="40%"> <a accesskey="n" href="differences.html"><img src="../images/navigation/next.gif" alt="Next"></a></td></tr><tr><td valign="top" align="left" width="40%">Pseudo-Lambda Expressions </td><td align="center" width="20%"><a accesskey="h" href="index.html"><img src="../images/navigation/home.gif" alt="Home"></a></td><td valign="top" align="right" width="40%"> Operators that differ from Java's operators</td></tr></table></div></body></html>
|