From 2dc7d8856d5f33e3acdf44f1b71e8f30e7d60bf6 Mon Sep 17 00:00:00 2001 From: Lukas Eder Date: Fri, 25 May 2012 14:34:11 +0200 Subject: [PATCH] [#1449] Generate some meaningful Javadoc into the generated [schema-name]Factory classes --- .../src/main/java/org/jooq/util/DefaultGenerator.java | 7 ++++++- .../org/jooq/test/h2/generatedclasses/PublicFactory.java | 4 +++- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/jOOQ-codegen/src/main/java/org/jooq/util/DefaultGenerator.java b/jOOQ-codegen/src/main/java/org/jooq/util/DefaultGenerator.java index fef8250845..eb9df0d254 100644 --- a/jOOQ-codegen/src/main/java/org/jooq/util/DefaultGenerator.java +++ b/jOOQ-codegen/src/main/java/org/jooq/util/DefaultGenerator.java @@ -207,7 +207,12 @@ public class DefaultGenerator extends AbstractGenerator { outF = new GenerationWriter(strategy.getFile(schema, Mode.FACTORY)); printHeader(outF, schema); - printClassJavadoc(outF, schema); + printClassJavadoc(outF, + "A Factory for specific use with the " + schema.getOutputName() + + " schema.

This Factory will not render the " + schema.getOutputName() + + " schema's schema name in rendered SQL (assuming that you use it as the default schema on your connection!). Use the more generic {@link " + + database.getDialect().getFactory().getName() + + "} or the {@link " + Factory.class.getName() + "} instead, if you want to fully qualify tables, routines, etc."); outF.print("public class "); outF.print(strategy.getJavaClassName(schema, Mode.FACTORY)); diff --git a/jOOQ-test/src/org/jooq/test/h2/generatedclasses/PublicFactory.java b/jOOQ-test/src/org/jooq/test/h2/generatedclasses/PublicFactory.java index e06bdcfc9c..a9fd84b730 100644 --- a/jOOQ-test/src/org/jooq/test/h2/generatedclasses/PublicFactory.java +++ b/jOOQ-test/src/org/jooq/test/h2/generatedclasses/PublicFactory.java @@ -5,10 +5,12 @@ package org.jooq.test.h2.generatedclasses; /** * This class is generated by jOOQ. + * + * A Factory for specific use with the PUBLIC schema.

This Factory will not render the PUBLIC schema's schema name in rendered SQL (assuming that you use it as the default schema on your connection!). Use the more generic {@link org.jooq.util.h2.H2Factory} or the {@link org.jooq.impl.Factory} instead, if you want to fully qualify tables, routines, etc. */ public class PublicFactory extends org.jooq.util.h2.H2Factory { - private static final long serialVersionUID = -1105638453; + private static final long serialVersionUID = -904520167; /** * Create a factory with a connection