Permalink
Browse files

docs: correct the Javadoc and enforce with Checkstyle (#1236)

  • Loading branch information...
lordnelson authored and vlsi committed Jul 5, 2018
1 parent 481460a commit 08631ccdabdb8ba6d52f398e2b0b46a9cf0cafbf
Showing with 1,028 additions and 1,050 deletions.
  1. +2 −2 pgjdbc/src/main/checkstyle/checks.xml
  2. +43 −46 pgjdbc/src/main/java/org/postgresql/Driver.java
  3. +12 −16 pgjdbc/src/main/java/org/postgresql/PGConnection.java
  4. +3 −3 pgjdbc/src/main/java/org/postgresql/PGNotification.java
  5. +46 −44 pgjdbc/src/main/java/org/postgresql/PGProperty.java
  6. +9 −9 pgjdbc/src/main/java/org/postgresql/PGStatement.java
  7. +1 −1 pgjdbc/src/main/java/org/postgresql/copy/CopyManager.java
  8. +3 −3 pgjdbc/src/main/java/org/postgresql/copy/PGCopyInputStream.java
  9. +5 −5 pgjdbc/src/main/java/org/postgresql/copy/PGCopyOutputStream.java
  10. +12 −12 pgjdbc/src/main/java/org/postgresql/core/BaseConnection.java
  11. +1 −1 pgjdbc/src/main/java/org/postgresql/core/CachedQuery.java
  12. +6 −6 pgjdbc/src/main/java/org/postgresql/core/ConnectionFactory.java
  13. +2 −2 pgjdbc/src/main/java/org/postgresql/core/Encoding.java
  14. +7 −4 pgjdbc/src/main/java/org/postgresql/core/EncodingPredictor.java
  15. +1 −1 pgjdbc/src/main/java/org/postgresql/core/JavaVersion.java
  16. +2 −2 pgjdbc/src/main/java/org/postgresql/core/JdbcCallParseInfo.java
  17. +20 −20 pgjdbc/src/main/java/org/postgresql/core/PGStream.java
  18. +8 −8 pgjdbc/src/main/java/org/postgresql/core/ParameterList.java
  19. +12 −12 pgjdbc/src/main/java/org/postgresql/core/Parser.java
  20. +14 −14 pgjdbc/src/main/java/org/postgresql/core/Query.java
  21. +17 −19 pgjdbc/src/main/java/org/postgresql/core/QueryExecutor.java
  22. +4 −3 pgjdbc/src/main/java/org/postgresql/core/ReplicationProtocol.java
  23. +8 −8 pgjdbc/src/main/java/org/postgresql/core/ResultHandler.java
  24. +11 −11 pgjdbc/src/main/java/org/postgresql/core/ServerVersion.java
  25. +1 −1 pgjdbc/src/main/java/org/postgresql/core/SocketFactoryFactory.java
  26. +1 −1 pgjdbc/src/main/java/org/postgresql/core/TypeInfo.java
  27. +10 −10 pgjdbc/src/main/java/org/postgresql/core/Utils.java
  28. +4 −2 pgjdbc/src/main/java/org/postgresql/core/v3/CopyInImpl.java
  29. +1 −1 pgjdbc/src/main/java/org/postgresql/core/v3/CopyOperationImpl.java
  30. +3 −3 pgjdbc/src/main/java/org/postgresql/core/v3/CopyOutImpl.java
  31. +1 −1 pgjdbc/src/main/java/org/postgresql/core/v3/ExecuteRequest.java
  32. +17 −17 pgjdbc/src/main/java/org/postgresql/core/v3/QueryExecutorImpl.java
  33. +3 −3 pgjdbc/src/main/java/org/postgresql/core/v3/SimpleQuery.java
  34. +2 −2 pgjdbc/src/main/java/org/postgresql/core/v3/TypeTransferModeRegistry.java
  35. +1 −1 pgjdbc/src/main/java/org/postgresql/core/v3/replication/V3PGReplicationStream.java
  36. +1 −1 pgjdbc/src/main/java/org/postgresql/core/v3/replication/V3ReplicationProtocol.java
  37. +4 −4 pgjdbc/src/main/java/org/postgresql/ds/PGPooledConnection.java
  38. +1 −1 pgjdbc/src/main/java/org/postgresql/ds/PGPoolingDataSource.java
  39. +33 −44 pgjdbc/src/main/java/org/postgresql/fastpath/Fastpath.java
  40. +4 −4 pgjdbc/src/main/java/org/postgresql/fastpath/FastpathArg.java
  41. +1 −1 pgjdbc/src/main/java/org/postgresql/geometric/PGbox.java
  42. +3 −3 pgjdbc/src/main/java/org/postgresql/geometric/PGcircle.java
  43. +5 −5 pgjdbc/src/main/java/org/postgresql/geometric/PGline.java
  44. +2 −2 pgjdbc/src/main/java/org/postgresql/geometric/PGlseg.java
  45. +5 −5 pgjdbc/src/main/java/org/postgresql/geometric/PGpath.java
  46. +8 −8 pgjdbc/src/main/java/org/postgresql/geometric/PGpoint.java
  47. +3 −3 pgjdbc/src/main/java/org/postgresql/geometric/PGpolygon.java
  48. +3 −4 pgjdbc/src/main/java/org/postgresql/hostchooser/HostRequirement.java
  49. +2 −2 pgjdbc/src/main/java/org/postgresql/jdbc/AbstractBlobClob.java
  50. +4 −4 pgjdbc/src/main/java/org/postgresql/jdbc/BooleanTypeUtil.java
  51. +40 −40 pgjdbc/src/main/java/org/postgresql/jdbc/EscapedFunctions.java
  52. +37 −0 pgjdbc/src/main/java/org/postgresql/jdbc/EscapedFunctions2.java
  53. +5 −7 pgjdbc/src/main/java/org/postgresql/jdbc/PgArray.java
  54. +10 −12 pgjdbc/src/main/java/org/postgresql/jdbc/PgCallableStatement.java
  55. +1 −1 pgjdbc/src/main/java/org/postgresql/jdbc/PgClob.java
  56. +19 −19 pgjdbc/src/main/java/org/postgresql/jdbc/PgConnection.java
  57. +21 −31 pgjdbc/src/main/java/org/postgresql/jdbc/PgDatabaseMetaData.java
  58. +3 −3 pgjdbc/src/main/java/org/postgresql/jdbc/PgPreparedStatement.java
  59. +19 −20 pgjdbc/src/main/java/org/postgresql/jdbc/PgResultSet.java
  60. +1 −0 pgjdbc/src/main/java/org/postgresql/jdbc/PgResultSetMetaData.java
  61. +10 −10 pgjdbc/src/main/java/org/postgresql/jdbc/PgStatement.java
  62. +3 −3 pgjdbc/src/main/java/org/postgresql/jdbc/PreferQueryMode.java
  63. +4 −4 pgjdbc/src/main/java/org/postgresql/jdbc/TimestampUtils.java
  64. +4 −4 pgjdbc/src/main/java/org/postgresql/jdbc2/ArrayAssistant.java
  65. +1 −1 pgjdbc/src/main/java/org/postgresql/jdbc2/ArrayAssistantRegistry.java
  66. +18 −22 pgjdbc/src/main/java/org/postgresql/largeobject/BlobInputStream.java
  67. +7 −7 pgjdbc/src/main/java/org/postgresql/largeobject/BlobOutputStream.java
  68. +34 −44 pgjdbc/src/main/java/org/postgresql/largeobject/LargeObject.java
  69. +34 −46 pgjdbc/src/main/java/org/postgresql/largeobject/LargeObjectManager.java
  70. +1 −1 pgjdbc/src/main/java/org/postgresql/osgi/PGBundleActivator.java
  71. +2 −2 pgjdbc/src/main/java/org/postgresql/osgi/PGDataSourceFactory.java
  72. +3 −3 pgjdbc/src/main/java/org/postgresql/replication/LogSequenceNumber.java
  73. +2 −2 pgjdbc/src/main/java/org/postgresql/replication/PGReplicationConnection.java
  74. +10 −10 pgjdbc/src/main/java/org/postgresql/replication/PGReplicationStream.java
  75. +1 −1 pgjdbc/src/main/java/org/postgresql/replication/fluent/ChainedCommonCreateSlotBuilder.java
  76. +2 −2 pgjdbc/src/main/java/org/postgresql/replication/fluent/ChainedCommonStreamBuilder.java
  77. +5 −3 pgjdbc/src/main/java/org/postgresql/replication/fluent/ChainedCreateReplicationSlotBuilder.java
  78. +8 −5 pgjdbc/src/main/java/org/postgresql/replication/fluent/ChainedStreamBuilder.java
  79. +1 −1 pgjdbc/src/main/java/org/postgresql/replication/fluent/CommonOptions.java
  80. +3 −3 pgjdbc/src/main/java/org/postgresql/replication/fluent/logical/ChainedLogicalCreateSlotBuilder.java
  81. +1 −1 pgjdbc/src/main/java/org/postgresql/replication/fluent/logical/ChainedLogicalStreamBuilder.java
  82. +1 −1 pgjdbc/src/main/java/org/postgresql/replication/fluent/logical/LogicalReplicationOptions.java
  83. +1 −1 ...bc/src/main/java/org/postgresql/replication/fluent/physical/ChainedPhysicalCreateSlotBuilder.java
  84. +1 −1 pgjdbc/src/main/java/org/postgresql/replication/fluent/physical/ChainedPhysicalStreamBuilder.java
  85. +27 −101 pgjdbc/src/main/java/org/postgresql/ssl/SingleCertValidatingFactory.java
  86. +1 −1 pgjdbc/src/main/java/org/postgresql/ssl/jdbc4/LazyKeyManager.java
  87. +1 −1 pgjdbc/src/main/java/org/postgresql/ssl/jdbc4/LibPQFactory.java
  88. +3 −3 pgjdbc/src/main/java/org/postgresql/sspi/ISSPIClient.java
  89. +3 −3 pgjdbc/src/main/java/org/postgresql/sspi/NTDSAPI.java
  90. +7 −7 pgjdbc/src/main/java/org/postgresql/sspi/SSPIClient.java
  91. +21 −21 pgjdbc/src/main/java/org/postgresql/util/Base64.java
  92. +4 −4 pgjdbc/src/main/java/org/postgresql/util/ExpressionProperties.java
  93. +3 −1 pgjdbc/src/main/java/org/postgresql/util/LruCache.java
  94. +1 −1 pgjdbc/src/main/java/org/postgresql/util/MD5Digest.java
  95. +25 −25 pgjdbc/src/main/java/org/postgresql/util/PGInterval.java
  96. +5 −5 pgjdbc/src/main/java/org/postgresql/util/PGTimestamp.java
  97. +1 −1 pgjdbc/src/main/java/org/postgresql/util/PGmoney.java
  98. +6 −7 pgjdbc/src/main/java/org/postgresql/util/PGobject.java
  99. +15 −16 pgjdbc/src/main/java/org/postgresql/util/PGtokenizer.java
  100. +5 −5 pgjdbc/src/main/java/org/postgresql/util/ReaderInputStream.java
  101. +4 −4 pgjdbc/src/main/java/org/postgresql/util/URLCoder.java
  102. +96 −34 pgjdbc/src/main/java/org/postgresql/xa/PGXAConnection.java
  103. +1 −1 pgjdbc/src/main/java/org/postgresql/xa/RecoveredXid.java
  104. +1 −1 pgjdbc/src/test/java/org/postgresql/jdbc/DeepBatchedInsertStatementTest.java
  105. +2 −2 pgjdbc/src/test/java/org/postgresql/replication/LogicalReplicationStatusTest.java
  106. +6 −6 pgjdbc/src/test/java/org/postgresql/replication/LogicalReplicationTest.java
  107. +7 −7 pgjdbc/src/test/java/org/postgresql/test/TestUtil.java
  108. +3 −3 pgjdbc/src/test/java/org/postgresql/test/jdbc2/AutoRollbackTestSuite.java
  109. +2 −2 pgjdbc/src/test/java/org/postgresql/test/jdbc2/BaseTest4.java
  110. +4 −3 pgjdbc/src/test/java/org/postgresql/test/jdbc2/BatchExecuteTest.java
  111. +5 −5 pgjdbc/src/test/java/org/postgresql/test/jdbc2/BatchedInsertReWriteEnabledTest.java
  112. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc2/BlobTransactionTest.java
  113. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc2/CopyBothResponseTest.java
  114. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc2/DriverTest.java
  115. +4 −4 pgjdbc/src/test/java/org/postgresql/test/jdbc2/PGPropertyTest.java
  116. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc2/SearchPathLookupTest.java
  117. +5 −5 pgjdbc/src/test/java/org/postgresql/test/jdbc2/StatementTest.java
  118. +16 −17 pgjdbc/src/test/java/org/postgresql/test/jdbc2/TimezoneTest.java
  119. +5 −5 pgjdbc/src/test/java/org/postgresql/test/jdbc2/optional/BaseDataSourceTest.java
  120. +2 −2 pgjdbc/src/test/java/org/postgresql/test/jdbc2/optional/CaseOptimiserDataSourceTest.java
  121. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc2/optional/ConnectionPoolTest.java
  122. +2 −2 pgjdbc/src/test/java/org/postgresql/test/jdbc4/ClientInfoTest.java
  123. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc4/IsValidTest.java
  124. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jdbc4/WrapperTest.java
  125. +4 −4 pgjdbc/src/test/java/org/postgresql/test/jdbc4/jdbc41/CloseOnCompletionTest.java
  126. +2 −3 pgjdbc/src/test/java/org/postgresql/test/jdbc4/jdbc41/GetObjectTest.java
  127. +2 −2 pgjdbc/src/test/java/org/postgresql/test/jdbc4/jdbc41/SchemaTest.java
  128. +5 −5 pgjdbc/src/test/java/org/postgresql/test/jdbc4/jdbc41/SharedTimerClassLoaderLeakTest.java
  129. +2 −2 pgjdbc/src/test/java/org/postgresql/test/jdbc42/SimpleJdbc42Test.java
  130. +1 −1 pgjdbc/src/test/java/org/postgresql/test/jre8/core/SocksProxyTest.java
  131. +1 −1 pgjdbc/src/test/java/org/postgresql/test/socketfactory/SocketFactoryTestSuite.java
  132. +18 −18 pgjdbc/src/test/java/org/postgresql/test/ssl/SingleCertValidatingFactoryTestSuite.java
  133. +1 −1 pgjdbc/src/test/java/org/postgresql/test/util/LruCacheTest.java
  134. +4 −2 pgjdbc/src/test/java/org/postgresql/test/util/rules/ServerVersionRule.java
  135. +3 −3 pgjdbc/src/test/java/org/postgresql/test/xa/XADataSourceTest.java
@@ -204,12 +204,12 @@
<property name="allowSamelineMultipleAnnotations" value="true"/>
</module>
<module name="NonEmptyAtclauseDescription"/>
<!--<module name="JavadocTagContinuationIndentation"/>-->
<module name="JavadocTagContinuationIndentation"/>
<!--Causes lots of "first sentence of javadoc is not followed by a period"-->
<!--<module name="SummaryJavadoc">-->
<!--<property name="forbiddenSummaryFragments" value="^@return the *|^This method returns |^A [{]@code [a-zA-Z0-9]+[}]( is a )"/>-->
<!--</module>-->
<!--<module name="JavadocParagraph"/>-->
<module name="JavadocParagraph"/>
<!--<module name="AtclauseOrder">-->
<!--<property name="tagOrder" value="@param, @return, @throws, @deprecated"/>-->
<!--<property name="target" value="CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, CTOR_DEF, VARIABLE_DEF"/>-->
@@ -38,21 +38,18 @@
import java.util.logging.StreamHandler;
/**
* The Java SQL framework allows for multiple database drivers. Each driver should supply a class
* that implements the Driver interface
* <p>The Java SQL framework allows for multiple database drivers. Each driver should supply a class
* that implements the Driver interface</p>
*
* <p>
* The DriverManager will try to load as many drivers as it can find and then for any given
* connection request, it will ask each driver in turn to try to connect to the target URL.
* <p>The DriverManager will try to load as many drivers as it can find and then for any given
* connection request, it will ask each driver in turn to try to connect to the target URL.</p>
*
* <p>
* It is strongly recommended that each Driver class should be small and standalone so that the
* Driver class can be loaded and queried without bringing in vast quantities of supporting code.
* <p>It is strongly recommended that each Driver class should be small and standalone so that the
* Driver class can be loaded and queried without bringing in vast quantities of supporting code.</p>
*
* <p>
* When a Driver class is loaded, it should create an instance of itself and register it with the
* <p>When a Driver class is loaded, it should create an instance of itself and register it with the
* DriverManager. This means that a user can load and register a driver by doing
* Class.forName("foo.bah.Driver")
* Class.forName("foo.bah.Driver")</p>
*
* @see org.postgresql.PGConnection
* @see java.sql.Driver
@@ -157,46 +154,48 @@ private Properties loadDefaultProperties() throws IOException {
}
/**
* Try to make a database connection to the given URL. The driver should return "null" if it
* <p>Try to make a database connection to the given URL. The driver should return "null" if it
* realizes it is the wrong kind of driver to connect to the given URL. This will be common, as
* when the JDBC driverManager is asked to connect to a given URL, it passes the URL to each
* loaded driver in turn.
* loaded driver in turn.</p>
*
* <p>
* The driver should raise an SQLException if it is the right driver to connect to the given URL,
* but has trouble connecting to the database.
* <p>The driver should raise an SQLException if it is the right driver to connect to the given URL,
* but has trouble connecting to the database.</p>
*
* <p>
* The java.util.Properties argument can be used to pass arbitrary string tag/value pairs as
* connection arguments.
* <p>The java.util.Properties argument can be used to pass arbitrary string tag/value pairs as
* connection arguments.</p>
*
* user - (required) The user to connect as password - (optional) The password for the user ssl -
* (optional) Use SSL when connecting to the server readOnly - (optional) Set connection to
* read-only by default charSet - (optional) The character set to be used for converting to/from
* <ul>
* <li>user - (required) The user to connect as</li>
* <li>password - (optional) The password for the user</li>
* <li>ssl -(optional) Use SSL when connecting to the server</li>
* <li>readOnly - (optional) Set connection to read-only by default</li>
* <li>charSet - (optional) The character set to be used for converting to/from
* the database to unicode. If multibyte is enabled on the server then the character set of the
* database is used as the default, otherwise the jvm character encoding is used as the default.
* This value is only used when connecting to a 7.2 or older server. loglevel - (optional) Enable
* logging of messages from the driver. The value is an integer from 0 to 2 where: OFF = 0, INFO =
* 1, DEBUG = 2 The output is sent to DriverManager.getPrintWriter() if set, otherwise it is sent
* to System.out. compatible - (optional) This is used to toggle between different functionality
* This value is only used when connecting to a 7.2 or older server.</li>
* <li>loglevel - (optional) Enable logging of messages from the driver. The value is an integer
* from 0 to 2 where: OFF = 0, INFO =1, DEBUG = 2 The output is sent to
* DriverManager.getPrintWriter() if set, otherwise it is sent to System.out.</li>
* <li>compatible - (optional) This is used to toggle between different functionality
* as it changes across different releases of the jdbc driver code. The values here are versions
* of the jdbc client and not server versions. For example in 7.1 get/setBytes worked on
* LargeObject values, in 7.2 these methods were changed to work on bytea values. This change in
* functionality could be disabled by setting the compatible level to be "7.1", in which case the
* driver will revert to the 7.1 functionality.
* driver will revert to the 7.1 functionality.</li>
* </ul>
*
* <p>
* Normally, at least "user" and "password" properties should be included in the properties. For a
* <p>Normally, at least "user" and "password" properties should be included in the properties. For a
* list of supported character encoding , see
* http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html Note that you will
* probably want to have set up the Postgres database itself to use the same encoding, with the
* {@code -E <encoding>} argument to createdb.
* {@code -E <encoding>} argument to createdb.</p>
*
* Our protocol takes the forms:
* <p>Our protocol takes the forms:</p>
*
* <PRE>
* <pre>
* jdbc:postgresql://host:port/database?param1=val1&amp;...
* </PRE>
* </pre>
*
* @param url the URL of the database to connect to
* @param info a list of arbitrary tag/value pairs as connection arguments
@@ -285,9 +284,9 @@ public Connection connect(String url, Properties info) throws SQLException {
private static String loggerHandlerFile;
/**
* Setup java.util.logging.Logger using connection properties.
* <p>
* See {@link PGProperty#LOGGER_FILE} and {@link PGProperty#LOGGER_FILE}
* <p>Setup java.util.logging.Logger using connection properties.</p>
*
* <p>See {@link PGProperty#LOGGER_FILE} and {@link PGProperty#LOGGER_FILE}</p>
*
* @param props Connection Properties
*/
@@ -470,12 +469,11 @@ public boolean acceptsURL(String url) {
}
/**
* The getPropertyInfo method is intended to allow a generic GUI tool to discover what properties
* it should prompt a human for in order to get enough information to connect to a database.
* <p>The getPropertyInfo method is intended to allow a generic GUI tool to discover what properties
* it should prompt a human for in order to get enough information to connect to a database.</p>
*
* <p>
* Note that depending on the values the human has supplied so far, additional values may become
* necessary, so it may be necessary to iterate through several calls to getPropertyInfo
* <p>Note that depending on the values the human has supplied so far, additional values may become
* necessary, so it may be necessary to iterate through several calls to getPropertyInfo</p>
*
* @param url the Url of the database to connect to
* @param info a proposed list of tag/value pairs that will be sent on connect open.
@@ -522,20 +520,19 @@ public static String getVersion() {
}
/**
* Report whether the driver is a genuine JDBC compliant driver. A driver may only report "true"
* <p>Report whether the driver is a genuine JDBC compliant driver. A driver may only report "true"
* here if it passes the JDBC compliance tests, otherwise it is required to return false. JDBC
* compliance requires full support for the JDBC API and full support for SQL 92 Entry Level.
* compliance requires full support for the JDBC API and full support for SQL 92 Entry Level.</p>
*
* <p>
* For PostgreSQL, this is not yet possible, as we are not SQL92 compliant (yet).
* <p>For PostgreSQL, this is not yet possible, as we are not SQL92 compliant (yet).</p>
*/
@Override
public boolean jdbcCompliant() {
return false;
}
/**
* Constructs a new DriverURL, splitting the specified URL into its component parts
* Constructs a new DriverURL, splitting the specified URL into its component parts.
*
* @param url JDBC URL to parse
* @param defaults Default properties
@@ -112,25 +112,21 @@
void addDataType(String type, String className);
/**
* This allows client code to add a handler for one of org.postgresql's more unique data types.
* <p>This allows client code to add a handler for one of org.postgresql's more unique data types.</p>
*
* <p>
* <b>NOTE:</b> This is not part of JDBC, but an extension.
* <p><b>NOTE:</b> This is not part of JDBC, but an extension.</p>
*
* <p>
* The best way to use this is as follows:
* <p>The best way to use this is as follows:</p>
*
* <pre>
* ...
* ((org.postgresql.PGConnection)myconn).addDataType("mytype", my.class.name.class);
* ...
* </pre>
*
* <p>
* where myconn is an open Connection to org.postgresql.
* <p>where myconn is an open Connection to org.postgresql.</p>
*
* <p>
* The handling class must extend org.postgresql.util.PGobject
* <p>The handling class must extend org.postgresql.util.PGobject</p>
*
* @param type the PostgreSQL type to register
* @param klass the class implementing the Java representation of the type; this class must
@@ -161,7 +157,7 @@
int getPrepareThreshold();
/**
* Set the default fetch size for statements created from this connection
* Set the default fetch size for statements created from this connection.
*
* @param fetchSize new default fetch size
* @throws SQLException if specified negative <code>fetchSize</code> parameter
@@ -171,7 +167,7 @@
/**
* Get the default fetch size for statements created from this connection
* Get the default fetch size for statements created from this connection.
*
* @return current state for default fetch size
* @see PGProperty#DEFAULT_ROW_FETCH_SIZE
@@ -209,11 +205,11 @@
String escapeLiteral(String literal) throws SQLException;
/**
* Returns the query mode for this connection.
* <p>
* When running in simple query mode, certain features are not available: callable statements,
* partial result set fetch, bytea type, etc.
* The list of supported features is subject to change.
* <p>Returns the query mode for this connection.</p>
*
* <p>When running in simple query mode, certain features are not available: callable statements,
* partial result set fetch, bytea type, etc.</p>
* <p>The list of supported features is subject to change.</p>
*
* @return the preferred query mode
* @see PreferQueryMode
@@ -6,19 +6,19 @@
package org.postgresql;
/**
* This interface defines the public PostgreSQL extension for Notifications
* This interface defines the public PostgreSQL extension for Notifications.
*/
public interface PGNotification {
/**
* Returns name of this notification
* Returns name of this notification.
*
* @return name of this notification
* @since 7.3
*/
String getName();
/**
* Returns the process id of the backend process making this notification
* Returns the process id of the backend process making this notification.
*
* @return process id of the backend process making this notification
* @since 7.3
Oops, something went wrong.

0 comments on commit 08631cc

Please sign in to comment.