Makumba Specification

<mak:list...>...</mak:list>

Performs a query on the database. The body of the list, if present, is run once for every item in the resulting data (size 0..N), e.g. to display it. Queries are generated on the spot and can be nested.

Example:

<mak:list from="best.Student s, s.person p" where="p.gender=\"male\""
          orderBy="p.name">

    <c:if test="${mak:count()==1}">
       <p> There are ${mak:maxCount()} male students:
    </c:if>

    <br> <%= counter %>.
    <mak:value expr="p.name"/>
    <mak:value expr="p.surname"/> <br>
    <mak:list from="p.addresses a">
       <mak:value expr="a.streetno"/> <mak:value expr="a.city"/>
    </mak:list>
</mak:list>

<c:if test="${mak:lastCount()==0}"> There are no male students. </c:if>

<mak:object  ...>.... </mak:object>

Like list, but the query can only have zero or one result. A zero value for maxCountVar and countVar indicate that the object does not exist.

Example: See <mak:list>.

Attributes and OQL in <mak:list > and <mak:object >

Attributes are accessible through $AttributeName to any makumba tag. Typically they will be present in OQL sections instead of $number attributes (therefore the OQL sections of these tags is not "pure"). For example:

<mak:list from="best.internal.Lbg"
          where="lbg.country=$country"
          orderBy="lbg.$lbg_order">
  .....
</mak:list>

If a $ (dollar) sign needs to be in the string, the escape is $$.
If at the end of an attribute there has to be a Java identifier letter, the attribute name can be written as text1$attrName$text2, that is, with $ at both ends.

The http parameters are automatically set as page attributes. Other attributes can be set by the Java code as attributes in any scope (page, request, session, application) using pageContext.setAttribute(name, value, scope).

The query generator is setting all the attributes that are logically possible as prepared query parameters. For example, the $country above is a query parameter since it's a value, but the $lbg_order will not be accepted as query parameter, since it's a field name.

If an attribute has multiple values, it is expanded into multiple OQL parameters. For example:

<mak:list from="best.internal.Lbg" where="lbg.status in set($status)" >

<mak:value  .../>

Displays the value of an expression from within the query.

Example:

<mak:list from="best.Student s, s.person p"
	where="p.gender=\"male\"" orderBy="p.name">
    <mak:value expr="p.name"/>
    <mak:value expr="p.surname"/>
    <mak:value expr="p.birthdate" var="birth" printVar="printBirth"/>
    <% // we only print the birthdate if it's after some date
         if ( ((java.util.Date)birth).after(new java.util.Date(1980, 0, 1)) )
             out.print(printBirth);
    %>
    <mak:value expr="s.person.favoriteQuote" maxLength="60" addTitle="auto" />
</mak:list>

mak:count(), mak:maxCount(), mak:lastCount()

• mak:count() gives the number of the current iteration inside a mak:list or mak:object. It has no value outside that tag.
• mak:maxCount() gives the total number of iterations inside a mak:list or mak:object (1). It has no value outside that tag.
• mak:lastCount() gives the total number of iterations of the previous mak:list or mak:object, respectively. It has no value inside the mak:list/object.
  Note: if you want to store the value of some mak:list/object for usage in/after a later mak:list/object, you can do that with <c:set var="someVariableName" value="${mak:lastCount()}" just after that mak:list/object.

<mak:list ...>
   <c:if test="${mak:count()==1}">These are the list elements: </c:if>
   <tr bgcolor="${mak:count()%2==1?"white":"grey"}">
       <td>this shows in alternative colors</td>
   ...
   <c:if test="${mak:count()!=mak:maxCount()}">
       a separator where we can have any <b>tag</b> 
       we don't want separators to be shown after the last element 
   </c:if>
</mak:list>
<c:if test="${mak:lastCount()==0}">These are no elements </c:if>

<mak:if  ...> ... </mak:if>

Displays the body of the tag only if the OQL expression evaluates to true.

Example :

<mak:list from="best.Student s"
	  where="s.person.birthdate <> nil" orderBy="s.name">
   <mak:value expr="s.person.name"/>
   <mak:if test="s.person.hideAge = 0">
      was born on <mak:value expr="s.person.birthdate" />
   </mak:if>
</mak:list>

<mak:attribute  .../>

Displays the value of an attribute, or sets it to a Java variable.

Example:

<mak:attribute name="pattern" var="pattern" exceptionVar="exception"/>

<% if (exception!=null) {
     pageContext.setAttribute("pattern", (String)pattern+"%");
%>
   <mak:list from="type t" where="t.field like $pattern" >...</mak:list>

<% } else { %>
   No pattern argument. Please indicate one.
<% } %>