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

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.

• 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"

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>

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"/>