Human System

Simple HTTP Client for Scala

2011-11-03T18:11:00.001+09:00

I'm writing a Simple HTTP Client for Scala. This is a simple example of GET request:

using (new SimpleHttpClient()){ client =>
  val content: Option[String] = client.get(
    url = "http://localhost:8080/"
  )
  content match {
    case Some(s) => println(s)
    case None => println("Request Failed.")
  }
}

You can give request parameters to get() method. And it's possible to send POST request to use post() method instead of get() method. The second example shows how to give request parameters with the POST request:

using (new SimpleHttpClient()){ client =>
  val content: Option[String] = client.post(
    url = "http://localhost:8080/",
    params = Map("q" -> "Scala"),
    encode = "UTF-8"
  )
  ...
}

In default SimpleHttpClient returns the response body as Option[String]. You can handle the response to give the your own response handler. The response handler has to be a function has a signature (HttpResponse => T).

using (new SimpleHttpClient()){ client =>
  val content: Array[Byte] = client.post(
    url = "http://localhost:8080/",
    handler = { r: HttpResponse =>
      r.getStatusLine.getStatusCode match {
        case HttpStatus.SC_OK => 
          EntityUtils.toByteArray(r.getEntity())
        case _ => 
          throw new RuntimeException("Request Failed.")
      }
    }
  )
  ...
}

SimpleHttpClient also supports http proxy. You can give proxy settings to the constructor.

using(new SimpleHttpClient(
    "proxy.example.com:8080")){ client =>
  ...
}

I'm making useful utilities like this HTTP Client for development of general Scala based applications at scala-utils.

xsbt-scalate-precompile-plugin 1.6

2011-10-31T11:09:00.001+09:00

xsbt-scalate-precompile-plugin is a sbt plug-in which makes precompilation Scalate templates in the sbt build process (Scalate is a template engine for Scala).

However xsbt-scalate-precompile-plugin 1.5 had one serious problem which does not process templates in the nested directory. For example, it could't handle the layout template (which have to be placed into WEB-INF/scalate/layouts) correctly.

I made a patch to fix this problem and send it. It's taken in xsbt-scalate-precompile-plugin 1.6.

The fixed version of xsbt-scalate-precompile-plugin 1.6 is already available! Now it can process templates in the nested directory correctly.

Introduction of CookieSessionFilter

2011-09-23T02:41:00.000+09:00

CookieSessionFilter is a servlet filter which stores session data into the client cookie for Java based web applications.

In using CookieSessionFilter, session replication becomes unnecessary for multiplexing of application servers. You'll be able to make and manage multiplexing environment more easily.

It provides HttpSession interface. So any modification in your application is not necessary. Probably, you'll be able to use it with not so large cost.

See details about CookieSessionFilter at:
http://amateras.sourceforge.jp/site/cookie-session-filter/usage.html

eclipse-scala-tools 0.0.2 is now available!

2011-08-20T16:04:00.006+09:00

eclipse-scala-tools provides some small Eclipse plug-ins for Scala. It supplements ScalaIDE for Eclipse. The current version of eclipse-scala-tools provides features that support SBT.

See details about eclipse-scala-tools at the following URL:

https://bitbucket.org/takezoe/eclipse-scala-tools/wiki/Home

New features in eclipse-scala-tools 0.0.2:

SBT 0.10 Support
Proxy Settings
SBT Console (SBT > Open SBT Shell)
Built-In SBT Runtime

I hope it helps your Scala development!

AmaterasUML 1.3.3 is now available!

2011-08-13T16:12:00.001+09:00

Project Amateras released AmaterasERD 1.3.3 at 13 August 2011.

New features in this release:

Improvement of constructor in the class diagram
Improvement of Java generics support
Quick Filter ("Show only Public" and "Show All")
Refresh the class diagram from Java source
Copy the diagram as image

See details about AmaterasUML at:
http://amateras.sourceforge.jp/cgi-bin/fswiki_en/wiki.cgi?page=AmaterasUML

See details about new features in AmaterasUML 1.3.3 at:
http://sourceforge.jp/projects/amateras/wiki/AmaterasUML_1_3_3

Download AmaterasUML 1.3.3 from:
http://sourceforge.jp/projects/amateras/downloads/52922/AmaterasUML_1.3.3.zip/

Enjoy your development!

Eclipse Plug-in for SBT

2011-08-12T15:41:00.008+09:00

Today, I released eclipse-scala-tools 0.0.1.

eclipse-scala-tools is some small Eclipse plug-ins for Scala. It supplements ScalaIDE for Eclipse.

In the initial release of eclipse-scala-tools provides SBT 0.7.x support on Eclipse.

You can create a SBT project using wizard.

Run SBT command from the context menu of the project. You can also migrate existing SBT projects by 'Migrate SBT Project to Eclipse'.

By this plug-in, we would be able to use SBT with Eclipse without special method such as Eclipsify.

I'm planning to add some more features to eclipse-scala-tools such as unit testing support.

Mirage 1.1.3 is now available!

2011-08-07T01:21:00.002+09:00

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

New features in Mirage 1.1.3:

Added SchemaUpdater and SchemaUpdateListener to update database schema automatically.
Added Session#setRollbackOnly() and Session#isRollbackOnly() to rollback transaction without exception.
SQL parsing result caching for performance improvement. You can control cache mode via SqlManagerImpl#setCacheMode().
Oracle hint support in 2-way SQL
Added ResultEntityCreator interface to extends SqlManager.
Added PropertyExtractor interface to extends BeanDesc.
Scala wrapper named mirage-scala is available.

This release contains the first release of mirage-scala. This is a wrapper of Mirage for Scala.

I have tested so many features and patterns in mirage-scala. However I couldn't believe how interface is best for mirage-scala. So I decided to release with minimum features in the first release. mirage-scala has not enough features now, however it will be expanded in the future.

I hope Mirage helps your development. Enjoy!

mirage-scala: Scala binding of Mirage

2011-07-15T11:06:00.007+09:00

I started working for mirage-scala that is Scala binding of Mirage. mirage-scala works as wrapper of Mirage and provides the best interface to access to the database using Mirage for Scala.

This is a simple example to query using mirage-scala:

// A class that mapped to ResultList
class Book (
  val bookId: Int,
  val bookName: String,
  val author: String,
  val price: Int
)

// get Session and SqlManager
val session: Session = SessionFactory.getSession()
val sqlManager: SqlManager = session.getSqlManager()

// begin transaction
session.begin()

try {
  val books: List[Book] = sqlManager.getResultList(
    classOf[Book], Sql("""
      SELECT BOOK_ID, BOOK_NAME, AUTHOR, PRICE
      FROM BOOK
      /*IF author!=null*/
        WHERE AUTHOR = /*author*/
      /*END*/
    """), Map("author"->"Naoki Takezoe"))
  
  books.foreach { book =>
    println("bookId: " + book.bookId)
    println("bookName: " + book.bookName)
    println("author: " + book.author)
    println("price: " + book.price)
    println("--")
  }
  
  // commit transaction
  session.commit()
} catch {
  // rollback transaction
  ex: Exception => session.rollback()
}

A most important feature of Mirage is dynamic SQL template named 2waySQL. In Mirage, you have to create it as an external file on the classpath. However in mirage-scala, you can write it inline using multi-line string literal. Of course, you can also use an external file as following:

val result: List[Book] = sqlManager.getResultList(
  classOf[Book], 
  SqlFile("META-INF/selectBooks.sql"), 
  Map("author"->"Naoki Takezoe"))

mirage-scala is still under development. I'm evaluating APIs feaibility. So APIs might be changed considerably in the release version.

Mirage 1.1.2 is now available!

2011-05-01T11:37:00.003+09:00

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

New features in Mirage 1.1.2:

Added DBCPSessionImpl to provide connection pooling as standalone usage.
Added TransactionInterceptor and @Transactional for Guice Intagration.
MockSqlManager came to support stored procedure / function.

This release does not contain so big new features. However it can be used in more large fields such as small web applications by connection-pooling in standalone usage.

I wish that Mirage helps your development. Enjoy!

AmaterasERD 1.0.8 is now available!

2011-02-13T16:21:00.005+09:00

Project Amateras released AmaterasERD 1.0.8 at 12 February 2011.

New features in this release:

Sybase support
In importing and exporting, table and column comments are mapped to logical name (Oracle and Sybase only)
Copy As Image from the context menu
Quick Outline ([CTRL]+[O])
Diagram font configuration
HTML generation tool from *.erd file which could be used in command-line

See details about AmaterasERD at:
http://amateras.sourceforge.jp/cgi-bin/fswiki_en/wiki.cgi?page=AmaterasERD

See details about new features in AmaterasERD 1.0.8 at:
http://sourceforge.jp/projects/amateras/wiki/AmaterasERD_1_0_8

You can download AmaterasERD 1.0.8 from:
http://sourceforge.jp/projects/amateras/downloads/50912/net.java.amateras.db_1.0.8.jar/

Enjoy your development!

Unit Testting in Mirage

2011-01-15T20:55:00.004+09:00

In the unit-testing for database access code, some testing frameworks such as DbUnit are available. However, as you know, to maintain test data is very painful.

Mirage proposes lightweight unit-testing without database for database access code. It's based on string matching of executed SQL and expected SQL. Executed SQLs don't reach to the database actually, they are intercepted and recorded to MirageTestContext by using MockSqlManager.

You can verify executed SQLs and these parameters through MirageTestContext as below:

@Test
public void testGetBookById(){
  // set MockSqlManager to the test target
  BookService bookService = new BookService();
  bookService.setSqlManager(new MockSqlManager());

  // configure results which would be 
  // returned by MockSqlManager.
  Book book = new Book();
  book.setBookName("Mirage in Action");

  MirageTestContext.addResult(book);

  // execute
  Book result = bookService.getBookById(new Long(100));

  // assert returned object
  assertEquals("Mirage in Action", book.getName);

  // verify the number of executed SQL
  MirageTestContext.verifySqlCount(1);

  // verify the executed SQL
  MirageTestContext.verifySqlByRegExp(0,
    "SELECT .* FROM BOOK " + 
    "WHERE ID = ? ORDER BY ID ASC", // verify SQL
    new Long(100)); // verify Parameters
}

As you see, you can also configure return values of MockSqlManager using MirageTestContext if it's necessary. You can write your test case more simple by static importing of MirageTestContext members.

Please note, the purpose of this way is not to verify whether executed SQLs are correct. It helps to find influence which is not anticipated by modification of database access code. So it requires to current database access code and SQLs are correct.

If your purpose of unit-testing for database access code is matches this concept, Mirage will decrease a cost of unit-testing and maintaining them very much.

Mirage 1.1.0 is now available!

2011-01-15T17:14:00.007+09:00

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

New features in Mirage 1.1.0:

Primary key generation support

@PrimaryKey annotation has new attributes generationType and generator. The generationType attribute supports GenerationType.APPLICATION, GenerationType.IDENTIY and GenerationType.SEQAUENCE.
The persistent attribute of @PrimaryKey annotation has been removed.

Improvement of unit testing support

Verification methods of MirageTestContext have been enhanced.

New ConnectionProvider and Dialect

Added JNDIDataSourceConnectionProvider and JNDIXADataSourceConnectionProvider which obtain a dada source from JNDI.
Added MySQLDialect to MySQL support.

I wish that Mirage helps your development. Enjoy!

Mirage 1.0.6 is now available!

2011-01-02T14:06:00.004+09:00

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

Here is the list of changes in Mirage 1.0.6:

Unit Testing support
- Added MockSqlManager which is used in unit testing instead of SqlManager. See details about Unit Testing support at the UnitTest section.
Ant Task
- Added EntityGenTask for entity generation.

In addition, Apache Click example is updated which contains examples of TestCase using MockSqlManager. You can get it from the download page.

I wish that Mirage helps your development. Enjoy!

rdiff-backup browser

2010-12-19T00:20:00.008+09:00

Project Amateras released rdiff-backup browser at Nov. 18, 2010.

rdiff-backup browser is a web application to browse backup histories of rdiff-backup. It is written in Java and works on the Java application server such as Apache Tomcat.

Mirage 1.0.5 is now available!

2010-10-05T08:28:00.001+09:00

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

Here is the list of changes in Mirage 1.0.5:

Add new methods to SqlManager for batch insert/update/delete entities:
- SqlManager#insertBatch()
- SqlManager#updateBatch()
- SqlManager#deleteBatch()
BugFix: NullPointerException which is caused in conversion from NULL column value to java.util.Date.
Possible to specify @In, @Out, @InOut, @ResultSet for setter / getter method.
Add new annotations @Table, @Column. These annotation are used to specify table and column name.
Entity Generation Tool (Experimental). See the EntityGen Javadoc to know how to use it.

In addition, Apache Click example is updated to use Apache Click 2.2.0 and Mirage 1.0.5. You can get it from the download page.

I wish that Mirage helps your development. Enjoy!

Java Standard EL Functions 1.1.1 is available!

2010-10-01T01:06:00.003+09:00

We released Java Standard EL Functions (JSEL) ver 1.1.1.

JSEL provides standard JSP-EL functions for web application development such as escaping HTML tags, URL encoding and formatting Date or Number. You can use it with many web frameworks which use JSP as view technologies.

Here is the list of new features in this release:

New functions to print message to JSP by log level
New functions to test whether log level is enabled

You can print message if the log log level is enabled using functions such as log:printDebug().

${log:printDebug('DEBUG level is enabled.')}

And also you can test whether log level is enabled using log:isDebugEnabled().

<c:if test="${log:isDebugEnabled()}">
  DEBUG level is enabled.
</c:if>

Please see the TLDDoc to know details of available functions.

Mailing list for Mirage is now available!

2010-09-28T13:30:00.005+09:00

Mailing list for Mirage is now available.

You can subscribe this list at the following page:
http://lists.sourceforge.jp/mailman/listinfo/amateras-mirage

And Mirage 1.0.5 which contains some new features such as batch updating and entity generation tool and also new click-mirage-examples would be released soon!

Mirage 1.0.4 Released!

2010-09-04T12:02:00.002+09:00

Mirage 1.0.4 is now available!

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

Here is the list of changes in Mirage 1.0.4:

JavaSE 5 support (Mirage 1.0.3 and before work with only JavaSE 6)
BugFix: Map which contains null properties causes NullPointerException in SqlManager#executeUpdate()
BugFix: When the column value is NULL then Mirage sets the default value of primitive types to entity wrapper type properties.
Add new methods to SqlManager for direct sql execution:
- SqlManager#getResultListBySql()
- SqlManager#getSingleResultBySql()
- SqlManager#iterateBySql()
- SqlManager#executeUpdatySql()

I wish that Mirage helps your development. Enjoy!

ClickIDE 2.2.0.0 is now available!

2010-07-20T11:15:00.002+09:00

ClickIDE 2.2.0.0 is now available!

ClickIDE is an Eclipse plug-in for the developing Click web applications.

This version supports Apache Click 2.2.0 and fixed some issues.

Details about ClickIDE:: http://click.apache.org/docs/click-ide.html
Download page:: http://click.apache.org/docs/click-ide-downloads.html

Enjoy Click!

EclipseHTMLEditor 2.0.7 Released!

2010-07-05T23:38:00.005+09:00

Project Amateras released EclipseHTMLEditor 2.0.7 at 05 July 2010.

EclipseHTMLEditor is an Eclipse plug-in which provides HTML, XML, JSP, JavaScript, CSS and DTD editor.

The main topic of this release is improvement of JavaScript editor. Enhanced JavaScript parser provides many new features for code completion, hyperlink and the outline view.

Here is a list of new features in this release.

JavaScript editor improvenemnt
- Code completion was greatly improved
- jQuery code completion
- Quick Outline (CTRL + O)
- JsDoc support
- Selected word highlighting
XPath search dialog is available in the HTML editor
Configurable HTML/JSP formatter
Synchronization of the caret offset and outline view selection in HTML, XML, JSP and JavaScript editor

See details here about new features.

Enjoy your development!

Mirage 1.0.3 Released

2010-06-15T05:37:00.002+09:00

Mirage 1.0.3 is now available!

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

Here is the list of changes in this release:

Iteration search per a record using cursor.
Stored procedure / function support.
BugFix about SqlManager#insertEntity().

Please see also my past entries about new features in Mirage 1.0.3.

I wish that Mirage helps your development. Enjoy!

Mirage supports stored procedure/function

2010-06-03T02:56:00.005+09:00

The next version of Mirage will support stored procedure/function. We added new methods to call them to SqlManager in the SVN trunk.

Here is an example to call stored function in Mirage:

// Creates parameter object which give to stored function
GetCountParam param = new GetCountParam();
param.deptId = 1;
...
// Calls a stored function and get a result value.
Long count = sqlManager.call(Long.class, "get_emp_count", param);

Fields of the parameter class has annotation such as @In, @Out, @InOut and @ResultSet. These annotations mean parameter type.

If the function returns ResultSet, use SqlManager#callForList() instead of SqlManager#call().

Please wait for the next release of Mirage!

Large results processing in Mirage

2010-05-09T01:55:00.005+09:00

The next release of Mirage is 1.0.3. It contains some new features. Today, I write about iteration search which is one of them.

SqlManager#getResultList() creates all entity instances and returns a list which contains them. If SQL returns a large result, it causes OutOfMemory.

In these case, you should use SqlManager#iterate() instead of SqlManager#getResultList().

Integer result = sqlManager.iterate(
  Book.class,
  new IterationCallback<Book, Integer>() {

    private int result;

    @Override public Integer iterate(Book entity) {
      result = result + entity.price;
      return result;
    }

  },
  SQL_PREFIX + "SqlManagerImplTest_selectBooks.sql");

SqlManager#iterate() accepts IterationCallback and invoke it per record. The return value of SqlManager#iterate() is a last returned value from IterationCallback.

Iteration search would be available in Mirage 1.0.3.

Mirage 1.0.2 Released!

2010-05-08T19:36:00.005+09:00

Mirage 1.0.2 is now available!

Mirage is a simple SQL centric database access library. See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

1.0.2 is a maintenance release. Here is the list of changes in this release:

Dependency to Spring Framework and Guice became optional.
Dependency to the pached OGNL changed to OGNL 2.7.3.
BugFix about BLOB support.

BLOB support in 1.0.1 does not work because it contains a serious bug. This bug was fixed in 1.0.2 and dependencies was reviewed and modified to minimum.

And also Mirage with Apache Click example is released. You can get it from the download page.

I wish that Mirage helps your development. Enjoy!

Mirage and Apache Click Example

2010-05-02T23:29:00.007+09:00

I started to make a sample application to use Mirage with Apache Click.

This sample application has not been completed yet. However you can checkout source code from the following URL using Subversion.

http://svn.sourceforge.jp/svnroot/amateras/mirage/trunk/mirage-click-example/

You can build a war file using Maven. Please execute following commands in command prompt.

$ svn co http://svn.sourceforge.jp/svnroot/amateras/mirage/trunk/mirage-click-example/
$ cd mirage-click-example
$ mvn package

Then you can find mirage-click-example.war in the /target directory.

Put it into the application server such as Tomcat and access http://localhost:8080/mirage-click-example/ using your browser.

Mirage 1.0.1 Released!

2010-05-02T02:43:00.005+09:00

Mirage is a simple SQL centric database access library. Today, I've just released Mirage 1.0.1. It's already available.

See the following URL to know about Mirage:

http://amateras.sourceforge.jp/site/mirage/welcome.html

Here is the list of new features in this release:

Use java.util.logging instead of slf4j / logback to remove them from dependency.
Simple example and documentation for Google Guice integration.
It's possible to specify a transient property by transient modifier instead of @Transient annotation.
Add new method SqlManager#findEntity(Class clazz, Object... id)
Add new method SqlManager#getCount(String sqlPath[, Object param])
ValueType interface to add custome value type support
BLOB support

Mirage is still not enough to use in complex systems. So we would improve it as much as possible soon.

Mirage: Simple SQL Centric DB Access Library

2010-04-20T17:20:00.008+09:00

Today, I released Mirage ver 1.0.0.

Mirage is a simple SQL centric database access library. It has a following two features:

2WaySQL
The main feature of Mirage is 2WaySQL. This makes plain old SQL template, and it is executable using any SQL client tools because parameters and conditions are written as SQL comment.
SQL less Update
Generally, update processing are simpler than search processing. However, especially, large INSERT SQL brings us the considerable pain. In the Mirage, you can insert / update / delete records using entity class (without SQL).

The main feature of Mirage is 2WaySQL. This makes plain old SQL template. See the following example:

SELECT * FROM BOOK
/*BEGIN*/
  WHERE
  /*IF author != null */
        AUTHOR = /*author*/'Naoki Takezoe'
  /*END*/
  /*IF minPrice != null */
    AND PRICE >= /*minPrice*/20
  /*END*/
  /*IF maxPrice != null */
    AND PRICE <= /*maxPrice*/100
  /*END*/
/*END*/
ORDER BY BOOK_ID ASC

Mirage processes this SQL template and executes it using PreparedStatement at runtime. And this SQL template is exacutable even it is on SQL client tools such as SQL*Plus(Oracle) or psql(PostgreSQL). So it makes easy to test SQL.

See details about Mirage at our web site. I would also talk about Mirage in this blog.

Java Standard EL Functions 1.1.0 is available!

2010-04-18T21:18:00.006+09:00

We released Java Standard EL Functions (JSEL) ver 1.1.0.

Here is the example to JSEL usage:

<%@ taglib uri="http://amateras.sf.jp/functions" prefix="f" %>
...
<%-- Escape HTML tags --%>
${f:h(value)}
<%-- URL encode --%>
${f:u(value)}

JSEL provides many usable EL functions. Please check our web site to know details about JSEL.

ClickIDE 2.1.0.0 Released

2010-02-27T19:14:00.005+09:00

ClickIDE 2.1.0.0 is now available!

This version is the first release of ClickIDE from Apache Software Foundation and it supports Eclipse 3.5 and Apache Click 2.1.0.

You can download it from the following link:
http://www.apache.org/dyn/closer.cgi/click/clickide/2.1.0.0/clickide-2.1.0.0.zip

Enjoy Click!

Doloto: JavaScript optimization tool

2009-09-21T22:13:00.004+09:00

Doloto is an AJAX application optimization tool provided at Microsoft DevLabs.

It works as an local proxy server, and it profiles JavaScript in Ajax applications. After profiling, Doloto groups JavaScripy functions as clusters based on profiled data. And rewrite original JavaScript code to load functions on demand using XMLHttpRequest.

Doloto is very simple and easy to use. It makes lazy loading of JavaScript with no changes of your applications.

Vilike: Open Source vi Plug-in for Eclipse

2009-09-05T09:50:00.006+09:00

viPlugin for Eclipse is a major plug-in that provides vi like key binding for Eclipse. However it's not open source. We have to buy license to use it (15 Euro).

Today, I found an open source vi plug-in named Vilike. I tested this plug-in and felt it good.

You can get it from the download page.

Download jp.gr.java_conf.mitonan.vilike_0.1.0.beta1.jar and put it into ECLIPSE_HOME/dropins.
Restart Eclipse and choose ViLike Key Binding Scheme ad the key binding schema in the Eclipse preference dialog ([General] - [Keys]).

Try Vilike plug-in if you want to bring Eclispe key binding close to the vi editor!

JSDT: JavaScript Debug Tool

2009-08-24T02:21:00.005+09:00

JSDT(JavaScript Debug Tools) is a JavaScript debugger that supports multi web browser without any add-ons.

Existing JavaScript debugger such as Firebug works for only specific web browsers or requires special add-ons. However JSDT has no requirement. It supports IE, Firefox, Chrome, Safari, Opera and many other browsers.

It works as the HTTP proxy server and this proxy inserts JavaScript code for debug into original JavaScript code. Inserted code sends debug information to debugger using Ajax.

JSDT provides a Swing based stand-alone debugger and an Eclipse plug-in. We can choose them by our development style.

Now, JSDT has some problem to debug JavaScript which contains multi-byte characters. So the current version is not so practicable. However JSDT's debugging mechanism looks epoch-making. I'm looking forward to the future of JSDT!

Utility to use JDO easily on Google App Engine

2009-07-26T22:14:00.008+09:00

We can use JDO to access BigTable on Google App Engine for Java.

However JDO PersistenceManager and Query object are so complex. So I wrote an utility to use JDO easily. For example, you can search entities as follows instead of JDO Query object.

List entries = JdoUtil.from(Entry.class)
  .filter("userId == ?")
  .ordering("updateDate desc")
  .range(0, 20)
  .getResultList(userId);

No need to cast result objects and Query#declareParameters() also.

I would like to provide this utility in the part of my NikoNiko Framework (NikoNiko means Smile in Japanese). NikoNiko Framework supports both standard JavaEE web development and Google App Engine for Java. It's small and lightweight. It would be suitable for the small web application development.

Empire-db: Type-safe query builder

2009-04-03T10:08:00.003+09:00

I found a new database access framework named Empire-db in the Apache Incubator.

A most important feature of Empire-db which I think is a type-safe query builder. See a following example from Empire-db's web site.

// Create a command object
DBCommand cmd = db.createCommand();
// Select columns
cmd.select(EMP.EMPLOYEE_ID);
cmd.select(EMP.LASTNAME.append(", ").append(EMP.FIRSTNAME).as("NAME"));
cmd.select(DEP.NAME.as("DEPARTMENT"));
// Join tables
cmd.join  (DEP.DEPARTMENT_ID, EMP.DEPARTMENT_ID);
// Set constraints
cmd.where(EMP.LASTNAME.likeUpper("Foo%"));
cmd.where(EMP.RETIRED.is(false));
// Set order
cmd.orderBy(EMP.LASTNAME);
cmd.orderBy(EMP.FIRSTNAME);

This feature is very useful at the software development projects which face many changes of database schema. Because compilation errors are caused by changes of database schema. We can fix these errors completely and surely soon.

Toggle comment in the Velocity editor

2009-01-02T01:14:00.004+09:00

I've just start development of the next version of ClickIDE.

I added Toggle Comment action to the Velocity editor. You can toggle comment for selected lines by the context menu or CTRL + /.

By the way, Now I'm planning JSP and FreeMarker support in the next version of ClickIDE. I have no concrete idea yet, but I wish to provide FreeMarker editor which has features same as the Velocity editor.

ClickIDE 2.1.0 Released

2008-11-12T13:29:00.001+09:00

ClickIDE 2.1.0 is now available!

ClickIDE is an Eclipse/WTP plug-in for web application development using Click. This release has not new features however it supports Click 1.5 and Eclipse 3.4/WTP 3.0.

Please download ClickIDE 2.1.0 and enjoy Click!!

Url Rewrite Filter: Make Clean URL in Click Framework

2008-10-08T16:18:00.007+09:00

Url Rewrite Filter is a servlet filter which provides features similar to the mod_rewrite. We can make clean URL in Click Framework using Url Write Filter.

Url Rewrite Filter has a configuretion file WEB-INF/urlrewrite.xml. This is a very simple example of clean URL with a Click application.

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE urlrewrite
  PUBLIC "-//tuckey.org//DTD UrlRewrite 2.6//EN"
  "http://tuckey.org/res/dtds/urlrewrite2.6.dtd">

<urlrewrite>
  <rule>
    <from>^/contents/([0-9]+).htm$</from>
    <to type="forward">/content.html?contentId=$1</to>
  </rule>
</urlrewrite>

For example, Url Rewrite Filter will forward /contents/001.htm to /content.htm?contentId=001.

If content.htm has possibility to receive any other query parameters, we can define following rules.

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE urlrewrite
  PUBLIC "-//tuckey.org//DTD UrlRewrite 2.6//EN"
  "http://tuckey.org/res/dtds/urlrewrite2.6.dtd">

<urlrewrite>
  <!-- No Query String -->
  <rule>
    <from>^/contents/([0-9]+).htm$</from>
    <to type="forward">/content.html?contentId=$1</to>
  </rule>
  <!-- With Query String -->
  <rule>
    <from>^/contents/([0-9]+).htm?(.+)$</from>
    <to type="forward">/content.html?contentId=$1&$2</to>
  </rule>
</urlrewrite>

Of course, we can use Url Write Filter with other frameworks such as Struts. I think Url Write Filter is a simple solution to make clean URL in the Java web applications.

Ajax Controls for Click Framework

2008-08-15T21:32:00.004+09:00

I'm thinking about Ajax integration for Click Framework recently.

For example, see the below page class. If you clicks AjaxRequestButton, Click invokes getAllBooks() using XMLHttpRequest. And getAllBooks() renders a Java object as JSON. AjaxRequestButton generates a HTML button that invokes Ajax.Request of prototype.js.

public class AjaxPage extends AjaxPage {
  public AjaxRequestButton button
    = new AjaxRequestButton("search", this, "getAllBooks");
  
  public AjaxPage(){
    button.addAjaxHandler(
      AjaxRequestButton.ON_COMPLETE, "displayResult");
  }
  
  public boolean getAllBooks(){
    List<Book> books = bookService.getAllBooks();
    renderJSON(books);
    return false;
  }
}

Next example. AjaxSubmit control send Form using Ajax.Request.

public class AjaxPage extends AjaxPage {

  public Form form = new Form("form");
  private TextField keyword = new TextFiled("keyword");
  private AjaxSubmit search = new AjaxSubmit("search", this, "onSearch");
  
  public AjaxPage(){
    form.add(keyword);
    form.add(search);
  }
  
  public boolean onSearch(){
    List<Book> bookList = bookService.search(keyword.getValue());
    renderJSON(books);
    return false;
  }
}

Of course, these controls need more improvement. However I think this concept matches to Click Framework well.

S2Click: Seasar2 integration for Click Framework

2008-08-14T16:27:00.005+09:00

S2Click is Seasar2 integration for Click Framework. Seasar2 is an opensource DI container made in Japan. S2Click adds powerful features to Click.

HOT deploy - You don't have to restart application server when you modify your sourcecode.
Java5 annotation - S2Click provides some annotations for ease of development
Ajax & File download support - The page base class S2ClickPage provides methods to render Ajax & file downloading response.
public field handling - You can use public fields instead of setter & getter in many places.
Extended controls - S2ClickForm, ToolTip, ConfirmSubmit, AjaxLinks and AjaxButtons

Now, Seasar2 and S2Click focuses to Japanese developers (So documentation is provided with Japanese mainly).

However I will introduce S2Click detailed features in this blog. And also I will feedback these features to Click Framework from S2Click in the feature.

Click Framework goes to ASF!

2008-08-03T15:54:00.001+09:00

There are very good news. Click Framework will join to the Apache Incubator! The proposal has been accepted.

This is the first step of introducing Click Framework to many Java developers. I'll make effort to incubate Click Framework in the Apache Incubator.

AIR GEAR 1.0.0 Released!

2008-07-03T13:30:00.000+09:00

Yesterday, Project Amateras released AIR GEAR 1.0.0!

AIR GEAR is an open source IDE for Adobe AIR development. It works as an Eclipse plug-in so you can use it with many other Eclipse plug-ins and powerful features of Eclipse.

AIR GEAR has following features:

Supports both HTML and Flex based AIR application development
WISYWIG graphical editor for Flex
Automatic build and error reporting
AIR application launcher on the Eclipse

See this page about detailed use.

Enjoy your development!

memcached in Java

2008-06-24T12:00:00.002+09:00

I'm looking for memcached client library for Java. Then I found two libraries.

memcached client for java: memcached client for java is simple and synchronous mamcached client libraries. This is easy to use but not support CAS commands.
spymemcached: spymemcached supports asynchronous processing and CAS commands. Updating cache is high-speed. However implementation is very complex.

I think that many web applications don't require asynchronous cache processing. So I think mamcached client for java is better solution.

prototype.js and script.aculo.us

2008-06-20T21:08:00.004+09:00

The next version of Amateras JavaScript editor supports prototype.js and script.aculo.us. These libraries are proposed in code completion proposals.

prototype.js:

script.aculo.us:

In the future version, many other JavaScript libraries will be supported!

The page auto mapping without templates

2008-06-20T16:17:00.004+09:00

Click Framework provides the page auto mapping. This is the important feature to decrease amount of configuration.

However Click maps page classes to request-path from HTML templates. So page classes which do not have corresponded HTML template is not mapped automatically.

For example:

pages which share a HTML template
the page which returns JSON or file (response is written in the page class)

I'm thinking about annotations on Click Framework. How about the @Path annotation which specifies the auto mapping path to page classes.

@Path("/file-download.htm")
public class FileDonwloadPage extends Page {

  /**
   * Writes response for file downloading in this method.
   */
  @Override public void onRender() {
    HttpServletResponse res = getContext().getResponse();
    OutputStream out = res.getOutputStream();
    ...
  }

  /**
   * This method returns null to not render template,
   * because this class writes response contents for file download.
   */
  public String getPath(){
    return null;
  }
}

This is one idea of using annotation in Click Framework.

JavaScript Formatter

2008-04-22T10:43:00.000+09:00

EclipseHTMLEditor (a part of Amateras) provides the JavaScript editor. I added JavaScript source code formatter to the JavaScript editor. We can format JavaScript source code from the context menu.

Please wait for the next release of EclipseHTMLEditor!

JJUG Cross Community Conference 2008 Spring

2008-04-21T18:00:00.007+09:00

JJUG Cross Community Conference 2008 Spring will be held at Japan 30 Apr.

JJUG is an abbreviation of Japan Java User Group. In this conference, top Java engineers in Japan talk about hot topics in Java such as Web frameworks, EclipseLink, JAM, Scala and New Swing APIs.

I'll talk about Click Framework in this conference and join panel discussion with speakers of Grails, JRuby on Rails and Wicket.

I wish to make efforts to spread Click Framework in Japan.

File download in Click Framework

2008-03-14T00:47:00.002+09:00

Click Framework provides FileField to upload file, however Click does not provide any support for file downloading. I made AbstractDownloadPage to download file.

Usage:

 public class SampleDownloadPage extends AbstractDownloadPage {
  public SampleDownloadPage(){
    setFileName("sample.txt");
    setContents(SampleDownloadPage.class.getResourceAsStream("sample.txt"));
  }
}

This page class does not have a template because response is written by this class. So auto-mapping does not work for file download pages. The extended page class have to be registered to click.xml.

Click Framework + LiveValidation

2008-03-10T01:30:00.003+09:00

Click controls provide JavaScript validation, but they are not easy to customize. Now I'm writing JavaScript validation framework for Click using LiveValidation. In the page class, ready the LivaValiator control like below:

Form form = new Form("form");
form.add(new TextField("name", true));
form.add(new PasswordField("password", true));
form.add(new Submit("login"));

addControl(new LivaValidator("validator", form));

In the page template, generates LiveValidation JavaScript code by the LiveValidator control:

<body>
  $form
  <script type="text/javascript">
    $validator
  </script>
</body>

We can also add customized validation rules by use of Validate.Custom.

OVal: The simple validation framework for Java

2008-03-09T22:30:00.007+09:00

OVal is the simple validation framework for Java. You can specify validation rules using annotations.

public class Person {
  @NotNull
  public String name;
}

Usage:

Validator v = new Validator();

Person p = new Person();
for(ConstraintViolation error: v.validate(p)){
  System.out.println(error.getMessage());
}

OVal can switch validation rules by profiles.

public class Person {
  @NotNull(profiles={"profile1"})
  public String name;
  
  @NotNull(profiles={"profile1", "profile2"})
  public String email;
}

Switch profiles like following:

// Enable all profiles
v.enableAllProfiles();
// Enable a specified profile
v.enableProfile("profile1");

// Disable all profiles
v.disableAllProfiles();
// Disable a specified profile
v.disableProfile("profile1");

JSONIC - simple json encoder/decoder for java

2008-02-21T10:46:00.005+09:00

JSONIC is a simple JSON encoder / decoder for Java made in Japan. We can get JSONIC from http://sourceforge.jp/projects/jsonic/files/. The use of JSONIC is very easy.

import net.arnx.jsonic.JSON;

// POJO to JSON
String text = JSON.encode(new Hoge());

// JSON to POJO
Hoge hoge = JSON.decode(text, Hoge.class);

JSONIC can handle POJO's public fields as property well and it also encode / decode java.util.Map and java.util.List.

I recommend JSONIC if you have to handle JSON in Java. It would be a best choice.

The First Seasar2 Example

2008-02-21T10:29:00.008+09:00

At first, I show the very simple example to use S2Container. I created following 3 files into "jp.sf.amateras.seasar.example" package.

example.dicon

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
          "http://www.seasar.org/dtd/components24.dtd">
<components>
  <component class="java.util.ArrayList" name="list">
    <initMethod name="add"><arg>"Naoki Takezoe"</arg></initMethod>
  </component>
</components>
<components>
  <component class="jp.sf.amateras.seasar.example.Hello" name="hello">
    <property name="target">list</property>
  </component>
</components>

Hello.java

package jp.sf.amateras.seasar.example;
import java.util.List;

public class Hello {
 private List target;
 public void setTarget(List target){
   this.target = target;
 }
 public void sayHello(){
   for(int i=0;i<target.size();i++){
     System.out.println("Hello, " + target.get(i));
   }
 }
}

Main.java

package jp.sf.amateras.seasar.example;
import org.seasar.framework.container.S2Container;
import org.seasar.framework.container.factory.S2ContainerFactory;

public class Main {
 public static void main(String[] args){
   S2Container container = S2ContainerFactory.create(
              "jp/sf/amateras/seasar/example/example.dicon");
   Hello hello = (Hello)container.getComponent("hello");
   hello.sayHello();
 }
}

Run the "Main" class as a Java application, it displays "Hello, Naoki Takezoe".

S2Dao: 2-Way SQL

2008-02-12T11:31:00.003+09:00

S2Dao can assemble dynamic query using SQL comment. For example:

@Sql("SELECT * FROM emp WHERE empno = /*empno*/7788")
@Arguments("empno")
public Emp selectEmpByEmpNo(int empNo);

/*empno*/ replaces the given argument and 7788 is removed by S2Dao at runtime. We can execute this SQL without no modification with the database client software such as psql. This solutuion is called "2-Way SQL" in S2Dao.

We can also use IF..ELSE statement as SQL comment.

/*IF hoge != null*/hoge = /*hoge*/'abc'/*END*/

And see the following example. If all conditions are false, S2Dao ignores /*BEGIN*/ ... /*END*/ block. So WHERE phrase is removed when it's not needed.

/*BEGIN*/WHERE
  /*IF job != null*/job = /*job*/'CLERK'/*END*/
  /*IF deptno != null*/AND deptno = /*deptno*/20/*END*/
/*END*/

Again, these SQL can be executed with database client software with no modifications. 2-Way SQL makes possible to test SQL easily.

S2Dao: The most powerfull database access framework

2008-02-11T23:36:00.003+09:00

S2Dao is a database access framework based on the Seasar2 and AOP solution. Today, I introduce this great framework to you.

S2Dao makes DAO from Java interface using AOP at runtime. We have to write only Java interface such as:

@S2Dao(bean=UserInfo.class)
public interface UserInfoDao {
  public List<UserInfo> selectAllUserInfos();
  public void insertUserInfo(UserInfo userInfo);
  public void updateUserInfo(UserInfo userInfo);
  public void deleteUserInfo(UserInfo userInfo);
}

SQLs are generated automatically by the entity definition (which is specified by @S2Dao) and DAO method names. So we don't have to write SQL in simple cases such as CRUD to the single table.

Of course, we can use complex SQL instead of auto generated SQL. We can specify WHERE and ORDER BY using @Query:

@Query("DEPTID=? ORDER BY EMPNO")
public List<UserInfo> selectUserInfoByDeptId(int deptId);

And using @Sql, we can specify all parts of SQL:

@Sql("SELECT COUNT(*) FROM USERINFO")
public int getCount();

These are parts of S2Dao great features. If we have to use complex and large SQL, we can write it as an external SQL file named "classname_methodname.sql" and S2Dao also support dynamic query using SQL comment. I will talk about them as another entries.

This is the first entry in Blogger!!

2008-02-11T23:18:00.001+09:00

This is the first entry in Blogger!!

I'm making a lot of Eclipse plug-ins at the Project Amateras. Eclipse is the major open source Java Integrated Development Environment. And I'm also commiter of the Click Framework. Click is powerful and simple web application framework for Java.

Now I'm interested in the small web development project using Java. Which frameworks should we use...? My one answer is here:

Seasar2 (DI/AOP container made in Japan)
S2Dao(Data Access Framework based on Seasar2)
Click Framework

Seasar2 is a poweful DI/AOP container made in Japan. I think Seasar2 is more easy than Spring in many cases. However Seasar2 does not have enough English docuements to use it. So I will try to tell about Seasar2 in this blog.