frostillic.us Blog

This blog template is a Darwino-based Jakarta EE application.

Server Requirements

The application requires a Java EE 9 and MicroProfile 5.0 container - it should work with any server that implements those, but has been developed and tested specifically with Open Liberty.

Environment Configuration

• The application assumes the presence of a PostgreSQL DB configured in an external "darwino-beans.xml" file
  • It also assumes the presence of the PostgreSQL JDBC driver on the global classpath
• The application uses Akismet for comment spam detection, and this should be configured with the frostillicus_blog.akismet-api-key and frostillicus_blog.akismet-blog properties in "darwino.properties" or any location known to the MicroProfile Config API
• The Darwino debug console (for admin users) can be enabled by setting the frostillicus_blog.dwo-runtime-debug-enable property to true in "darwino.properties"
• By default, the RSS feed uses the base URL from "translation.properties" in the j2ee project, but this can be overridden to use the incoming request information by setting frostillicus_blog.rss-request-urls to true in "darwino.properties"

JNDI Notes

If the database connection is set up via JNDI, then the Darwino bean should be configured to set the "objectTypeOther" driver property to "true", or else it will result in an error of "Can't infer the SQL type to use for an instance of org.postgresql.util.PGobject". For example:

<bean type="darwino/jsondb" name="frostillicus_blog" class="com.darwino.config.jsonstore.JsonDbJndi">
  <property name="db">postgresql</property>
  <property name="jndiPath">jdbc/postgresql</property>
  <map name="driverProperties">
    <entry key="objectTypeOther">true</entry>
  </map>
</bean>

Open Liberty Notes

To run on Open Liberty or WLP, the following feature set is required at minimum:

<features>
    <feature>appSecurity-4.0</feature>
    <feature>beanValidation-3.0</feature>
    <feature>cdi-3.0</feature>
    <feature>restfulWS-3.0</feature>
    <feature>servlet-5.0</feature>
    <feature>jsonb-2.0</feature>
    <feature>pages-3.3</feature>

    <feature>mpConfig-3.0</feature>
    <feature>mpRestClient-3.0</feature>
</features>

For JNDI database use, "jdbc-4-2" and "jndi-1.0" are also required. Alternatively, the "javaee-9.1" and "microprofile-5.0" features will cover everything.

The app can get very chatty in Liberty, spitting out stack traces when a post ID isn't found and periodically when something in the stack tries to set a header after the fact. This chatter can be reduced by ignoring a couple message codes in the server.xml:

<logging hideMessage="SRVE0315E,SRVE0777E,SRVE8115W,SRVE8094W"/>