You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

sqlcontainer-limitations.asciidoc 1.8KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. ---
  2. title: Known Issues and Limitations
  3. order: 9
  4. layout: page
  5. ---
  6. [[sqlcontainer.limitations]]
  7. = Known Issues and Limitations
  8. At this point, there are still some known issues and limitations affecting the
  9. use of SQLContainer in certain situations. The known issues and brief
  10. explanations are listed below:
  11. * Some SQL data types do not have write support when using TableQuery: ** All binary types
  12. ** All custom types
  13. ** CLOB (if not converted automatically to a [classname]#String# by the JDBC driver in use)
  14. ** See [classname]#com.vaadin.addon.sqlcontainer.query.generator.StatementHelper# for details.
  15. * When using Oracle or MS SQL database, the column name " [parameter]#rownum#" can
  16. not be used as a column name in a table connected to [classname]#SQLContainer#.
  17. +
  18. This limitation exists because the databases in question do not support
  19. limit/offset clauses required for paging. Instead, a generated column named
  20. 'rownum' is used to implement paging support.
  21. The permanent limitations are listed below. These can not or most probably will
  22. not be fixed in future versions of SQLContainer.
  23. * The [methodname]#getItemIds()# method is very inefficient - avoid calling it unless absolutely required!
  24. * When using [classname]#FreeformQuery# without providing a [classname]#FreeformStatementDelegate#, the row count query is very inefficient - avoid using [classname]#FreeformQuery# without implementing at least the count query properly.
  25. * When using [classname]#FreeformQuery# without providing a [classname]#FreeformStatementDelegate#, writing, sorting and filtering will not be supported.
  26. * When using Oracle database most or all of the numeric types are converted to
  27. [classname]#java.math.BigDecimal# by the Oracle JDBC Driver.
  28. +
  29. This is a feature of how Oracle DB and the Oracle JDBC Driver handles data
  30. types.