ensemblgenomes / dbcon Goto Github PK

Needs docs on:

*Config
*Pooling usage
*SQL Library usage
*Known issues

Maven can produce zips/tarballs so it should produce the distributions for
this project.

What steps will reproduce the problem?
1. Write a library in XML
2. Do not put the <?xml version="1.0" encoding="UTF8"?> declaration at the
top of the file
3. Watch DbCon attempt to read it as a .sqllib
4. Be amazed when your library is empty and has no errors (ooohhhh)

What is the expected output? What do you see instead?
It should populate the library correctly. It ends up with an empty one

This is an oversight in the definitions of the data source objects DbCon
provides. The fix should go into

http://dbcon.googlecode.com/svn/trunk/dbcon/src/main/java/uk/ac/sanger/cgp/dbcon
/core/AbstractDbConDataSource.java

What steps will reproduce the problem?
1. Have a template with more than 3 elements
2. Run
3. Watch it go wrong

What is the expected output? What do you see instead?

You should be able to template with more than 3 values.

=Problem=

For the given text query:

{{{
select 'Y' from dual
}}}

Currently the SqlLibrary code will return

{{{
select Y from dual
}}}

This will cause problems with the SQL component since ' quoted variables
are important for inline Strings in queries. This is caused by message
format from java.text.

=Considerations=

SqlLib is meant to tie a user as close to SQL as can be. Therefore nothing
about the underlying implementation of the formatter should be applied.
MessageFormat has a horrible possible syntax where this attempts to provide
a very simplistic templating solution.

=Solutions=

  # Make people aware of this limitation - done but I do not like this
  # Replace MessageFormat with another templating class
    * Just use another templater such as Velocity or StringTemplate. Feels
a bit like over kill
    * Have a custom templater which performs a series of replace operations
on the String. This would allow us to extend the templating to possibly
include text at a later date. I prefer this solution