diff --git a/en/about_nablarch/concept.rst b/en/about_nablarch/concept.rst index 965e3908a..4bd3e1bd6 100644 --- a/en/about_nablarch/concept.rst +++ b/en/about_nablarch/concept.rst @@ -28,4 +28,4 @@ However, for responding to a rapidly changing business environment, it is necess For achieving this, it is important to reuse proven parts. Nablarch is able to meet these needs by providing content that can be reused in a "ready-to-use" state, such as frameworks, adapters for adapting to frequently used middleware [1]_ and environments where inexperienced people can start developing immediately. -.. [1] Apache Log4j, WebSphere MQ, etc. +.. [1] Apache Log4j, IBM MQ, etc. diff --git a/en/application_framework/adaptors/jaxrs_adaptor.rst b/en/application_framework/adaptors/jaxrs_adaptor.rst index fd24ce5b1..6c04537af 100644 --- a/en/application_framework/adaptors/jaxrs_adaptor.rst +++ b/en/application_framework/adaptors/jaxrs_adaptor.rst @@ -11,8 +11,8 @@ Provides the following adapter to use in :ref:`RESTful web service `_ -* Adapter for using :ref:`RESTful web service ` with `Jersey (external site) `_ -* Adapter for using :ref:`RESTful web service ` with `RESTEasy (external site) `_ +* Adapter for using :ref:`RESTful web service ` with `Jersey (external site) `_ +* Adapter for using :ref:`RESTful web service ` with `RESTEasy (external site) `_ Module list -------------------------------------------------- @@ -53,7 +53,7 @@ Module list Using RESTful web services under Jersey environment ------------------------------------------------------- -If the implementation of `JAX-RS(external site) `_ bundled with the web application server is `Jersey(external site) `_ , use the adapter for Jersey. +If the implementation of `JAX-RS(external site) `_ bundled with the web application server is `Jersey(external site) `_ , use the adapter for Jersey. An application of Jersey adapter is shown below. @@ -87,7 +87,7 @@ For :java:extdoc:`JaxRsMethodBinderFactory#setHandlerList `_ bundled with the web application server is `RESTEasy (external site) `_ , use the adapter for RESTEasy. +If the implementation of `JAX-RS (external site) `_ bundled with the web application server is `RESTEasy (external site) `_ , use the adapter for RESTEasy. An application of RESTEasy adapter is shown below. diff --git a/en/application_framework/adaptors/log_adaptor.rst b/en/application_framework/adaptors/log_adaptor.rst index 69fc72596..825d7ef86 100644 --- a/en/application_framework/adaptors/log_adaptor.rst +++ b/en/application_framework/adaptors/log_adaptor.rst @@ -12,7 +12,7 @@ When an adapter is used, all log output processing using :ref:`the log output fu .. important:: - The log4j adapter that was provided up to Nablarch5u15 uses `log4j1.2 (external site) `_. log4j 1.2 is EOL. + The log4j adapter that was provided up to Nablarch5u15 uses `log4j1.2 (external site) `_. log4j 1.2 is EOL. Therefore, the log4j adapter has been deprecated as no fix for the `vulnerability `_ has been published. Use slf4j or JBoss Logging. .. tip:: diff --git a/en/application_framework/adaptors/micrometer_adaptor.rst b/en/application_framework/adaptors/micrometer_adaptor.rst index 3d502c4c3..cbe2db9f4 100644 --- a/en/application_framework/adaptors/micrometer_adaptor.rst +++ b/en/application_framework/adaptors/micrometer_adaptor.rst @@ -655,11 +655,11 @@ Working with Azure How to send metrics to Azure with Micrometer Azure provides the library using the Java agent (**Java 3.0 agent**) for sending metrics from Java applications to Azure. - * `Java codeless application monitoring Azure Monitor Application Insights(external site) `_ + * `Java codeless application monitoring Azure Monitor Application Insights(external site) `_ The Java 3.0 agent automatically collects metrics output to Micrometer's `Global Registry(external site) `_, and sends to Azure. - * `Send custom telemetry from your application(external site) `_ + * `Send custom telemetry from your application(external site) `_ .. important:: The Java 3.0 agent loads a large number of jar files during the initialization process. @@ -678,7 +678,7 @@ How to configure Micrometer adaptor * Add the Java 3.0 agent to your application's JVM args * Define a ``MeterRegistry`` component using the Global Registry - See the `Azure documentation(external site) `_ for how to set JVM args. + See the `Azure documentation(external site) `_ for how to set JVM args. This adaptor provides :java:extdoc:`GlobalMeterRegistryFactory ` for factory of Global Registry component. The following is an example of a component definition for this factory class. @@ -701,7 +701,7 @@ Configuration The metrics are sent by the Java 3.0 agent provided by Azure. Therefore, you must use configuration options provided by the Java 3.0 agent. - For more information, see `Configuration Options(external site) `_. + For more information, see `Configuration Options(external site) `_. .. important:: The configuration file for this adapter, ``micrometer.properties``, is not used. diff --git a/en/application_framework/adaptors/router_adaptor.rst b/en/application_framework/adaptors/router_adaptor.rst index cab7af4e5..259c91ffe 100644 --- a/en/application_framework/adaptors/router_adaptor.rst +++ b/en/application_framework/adaptors/router_adaptor.rst @@ -209,7 +209,7 @@ The following is an example implementation that defines the mapping using the `` @POST @Produces(MediaType.APPLICATION_JSON) - public int register(HttpRequest request) { + public int register(JaxRsHttpRequest request) { // Omitted } } @@ -224,7 +224,7 @@ In the above example implementation, the HTTP request will be dispatched as foll Path HTTP method Method of dispatching target ============ ============== ============================= ``/sample`` ``GET`` ``SampleAction#findAll()`` -``/sample`` ``POST`` ``SampleAction#register(HttpRequest)`` +``/sample`` ``POST`` ``SampleAction#register(JaxRsHttpRequest)`` ============ ============== ============================= .. tip:: @@ -265,8 +265,8 @@ In this case, the dispatch of the HTTP request would be as follows. ================ ============== ============================= Path HTTP method Method of dispatching target ================ ============== ============================= -``/sample/foo`` ``GET`` ``SampleAction#findAll()`` -``/sample/bar`` ``GET`` ``SampleAction#register(HttpRequest)`` +``/sample/foo`` ``GET`` ``TestAction#foo()`` +``/sample/bar`` ``GET`` ``TestAction#bar()`` ================ ============== ============================= Definition of path parameters @@ -281,16 +281,16 @@ Can also include parameters in the path, as follows @GET @Path("/foo/{param}") @Produces(MediaType.APPLICATION_JSON) - public Person foo(HttpRequest request) { - String param = request.getParam("param")[0]; + public Person foo(JaxRsHttpRequest request) { + String param = request.getPathParam("param"); // Omitted } @GET @Path("/bar/{id : \\d+}") @Produces(MediaType.APPLICATION_JSON) - public Person bar(HttpRequest request) { - int id = Integer.parseInt(request.getParam("id")[0]); + public Person bar(JaxRsHttpRequest request) { + int id = Integer.parseInt(request.getPathParam("id"); // Omitted } } @@ -299,7 +299,7 @@ Can also include parameters in the path, as follows | This is because this feature (routing definition with ``Path`` annotations) follows the JAX-RS specification. | By describing a part of the path as ``{parameter name}``, can define that part of the path as a parameter. -| Can get the value of the path parameter by passing the parameter name defined here to :java:extdoc:`HttpRequest#getParam(String) ` . +| Can get the value of the path parameter by passing the parameter name defined here to :java:extdoc:`JaxRsHttpRequest#getPathParam(String) ` . | In addition, can define the format of the path parameter in a regular expression by describing it as ``{parameter name: regular expression}``. | In the example implementation above, set the regular expression to ``\\d+``, so the method will be dispatched only if the path value is a number. @@ -309,10 +309,10 @@ An example of HTTP request dispatch would be as follows. ===================== ============== ============================= Path HTTP method Method of dispatching target ===================== ============== ============================= -``/sample/foo/hello`` ``GET`` ``SampleAction#foo(HttpRequest)`` -``/sample/foo/world`` ``GET`` ``SampleAction#foo(HttpRequest)`` -``/sample/bar/123`` ``GET`` ``SampleAction#bar(HttpRequest)`` -``/sample/bar/987`` ``GET`` ``SampleAction#bar(HttpRequest)`` +``/sample/foo/hello`` ``GET`` ``TestAction#foo(JaxRsHttpRequest)`` +``/sample/foo/world`` ``GET`` ``TestAction#foo(JaxRsHttpRequest)`` +``/sample/bar/123`` ``GET`` ``TestAction#bar(JaxRsHttpRequest)`` +``/sample/bar/987`` ``GET`` ``TestAction#bar(JaxRsHttpRequest)`` ===================== ============== ============================= See the list of routing definitions diff --git a/en/application_framework/adaptors/webspheremq_adaptor.rst b/en/application_framework/adaptors/webspheremq_adaptor.rst index 96fea7179..666a38d51 100644 --- a/en/application_framework/adaptors/webspheremq_adaptor.rst +++ b/en/application_framework/adaptors/webspheremq_adaptor.rst @@ -1,15 +1,15 @@ .. _webspheremq_adaptor: -IBM WebSphere MQ Adapter +IBM MQ Adapter ================================================== .. contents:: Table of contents :depth: 3 :local: -Provides an adapter to use `IBM WebSphere MQ (external site) `_ with :ref:`the MOM messaging function of Nablarch ` . +Provides an adapter to use `IBM MQ (external site) `_ with :ref:`the MOM messaging function of Nablarch ` . -Refer to the official Website and manuals of IBM Corporation for the specifications and construction procedures of WebSphere MQ. +Refer to the official Website and manuals of IBM Corporation for the specifications and construction procedures of IBM MQ. Module list -------------------------------------------------- @@ -22,8 +22,7 @@ Module list .. important:: - For WebSphere MQ jars, refer to the product manual and add those that are required to the class path. - The library included with WebSphere MQ v7.5 is used for testing. + The library included with IBM MQ v9.3 is used for testing. When changing the version, test in the project to confirm that there are no problems. Configuration for using this adapter @@ -37,7 +36,7 @@ A configuration example is shown below. .. code-block:: xml - + @@ -54,7 +53,7 @@ A configuration example is shown below. Use distributed transaction -------------------------------------------------- -This adapter includes a function to realize distributed transactions using IBM WebSphere MQ as the transaction manager. +This adapter includes a function to realize distributed transactions using IBM MQ as the transaction manager. This function is used to prevent omission and duplicate capture when sending and receiving messages to and from external systems. @@ -120,7 +119,7 @@ A configuration example is shown below. .. important:: - For using distributed transactions, an XA resource manager has to be configured for WebSphere MQ and authority to the database has to be granted. + For using distributed transactions, an XA resource manager has to be configured for IBM MQ and authority to the database has to be granted. Refer to the manual of the product to be used for the detailed configuration method and necessary authority. .. |br| raw:: html diff --git a/en/application_framework/application_framework/blank_project/CustomizeDB.rst b/en/application_framework/application_framework/blank_project/CustomizeDB.rst index 28ef9b044..d61dba422 100644 --- a/en/application_framework/application_framework/blank_project/CustomizeDB.rst +++ b/en/application_framework/application_framework/blank_project/CustomizeDB.rst @@ -79,7 +79,7 @@ The JDBC driver can be downloaded from the following site on the Internet. * - IBM DB2 JDBC Driver Versions |br| and Downloads - Japan - - http://www-01.ibm.com/support/docview.wss?uid=swg21363866 (External site) + - https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads (External site) An example of the command to register the downloaded JDBC driver to the local Maven repository is shown below. diff --git a/en/application_framework/application_framework/blank_project/FirstStep.rst b/en/application_framework/application_framework/blank_project/FirstStep.rst index d19b890c2..63a1d69aa 100644 --- a/en/application_framework/application_framework/blank_project/FirstStep.rst +++ b/en/application_framework/application_framework/blank_project/FirstStep.rst @@ -12,6 +12,7 @@ Initial Setup Procedure setup_blankProject/setup_NablarchBatch_Dbless setup_blankProject/setup_Java11 setup_blankProject/setup_Java17 + setup_blankProject/setup_Java21 .. toctree:: :maxdepth: 1 diff --git a/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst b/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst index 55bf4fc10..9d0305db2 100644 --- a/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst +++ b/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst @@ -12,6 +12,8 @@ When using blank projects in Java 17, perform the following procedure before com * Add --add-opens options (only for JSR352-compliant batch project) * Change of Java Version +.. _setup_blank_project_for_Java17_add_dependencies: + Add dependent module ------------------------------------------------------------- @@ -56,6 +58,7 @@ There are two differences from the :ref:`Add dependent module in Java 11 +.. _setup_blank_project_for_Java17_gsp_dba_maven_plugin: Configure gsp-dba-maven-plugin to work with Java 17 ---------------------------------------------------------- @@ -91,6 +94,7 @@ Therefore, make changes to 2 files as given below. +.. _setup_blank_project_for_Java17_add_JVMoption: Add --add-opens options (only for JSR352-compliant batch project) ------------------------------------------------------------------------------------------------------------------ diff --git a/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst b/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst new file mode 100644 index 000000000..b24ab7741 --- /dev/null +++ b/en/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst @@ -0,0 +1,66 @@ +.. _setup_blank_project_for_Java21: + +---------------------------------------------------------- +How to Setup When Using With Java21 +---------------------------------------------------------- + +When using blank projects in Java 21, perform the following procedure before communication confirmation of each blank project. + +* Add dependent module +* Configure gsp-dba-maven-plugin to work with Java 21 +* Change of Jetty module used in automatic test (only for web projects or RESTful web service projects) +* Add --add-opens options (only for JSR352-compliant batch project) +* Change the standard encoding（if you want the standard encoding to be the same execution environment as Java 17 or earlier） +* Change of Java Version + +Add dependent module +------------------------------------------------------------- + +The above steps are the same as when using Java 17, so refer to :ref:`setup_blank_project_for_Java17 ` + + +Configure gsp-dba-maven-plugin to work with Java 17 +---------------------------------------------------------- + +The above steps are the same as when using Java 17, so refer to :ref:`setup_blank_project_for_Java17 ` + + +Change of Jetty module used in automatic test (only for web projects or RESTful web service projects) +------------------------------------------------------------------------------------------------------------------ + +The above steps are the same as when using Java 17, so refer to :ref:`setup_blank_project_for_Java17 ` + + +Add --add-opens options (only for JSR352-compliant batch project) +------------------------------------------------------------------------------------------------------------------ + +The above steps are the same as when using Java 17, so refer to :ref:`setup_blank_project_for_Java17 ` + + +Change the standard encoding（If you want to make the standard encoding dependent on the execution environment as before Java 17） +---------------------------------------------------------------------------------------------------------------------------------------------------------- + +Since Java 18, the standard encoding is UTF-8, making it environment independent. If you want to make the standard encoding dependent on the execution environment as before Java 17, specify the system property as a runtime option for the Java command as shown below. + +* ``-Dfile.encoding=COMPAT`` + +.. tip:: + When running from Maven, the environment variable `MAVEN_OPTS (external site) `_ can be used to set the JVM options. However, ``Picked up MAVEN_OPTS: -Dfile.encoding=COMPAT`` is displayed in the log. + Please note that the settings for JVM options may differ depending on Maven plugin.(For example, in maven-surefire-plugin that runs the test, it needs to be specified in ``argLine`` in plugin settings in pom.xml) + +.. important:: + The ``-Dfile.encoding=COMPAT`` option is not valid until Java 17, so be careful not to apply this JVM option to previous execution environments. + +Change of Java Version +------------------------------ + +In a blank project, Java 8 is set as the Java version +that the source and class files conform to, so change the file as below. + +* pom.xml + +.. code-block:: xml + + + 21 + diff --git a/en/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst b/en/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst index 5b9f67c82..98e8aad64 100644 --- a/en/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst +++ b/en/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst @@ -327,6 +327,6 @@ By editing it like this, X-Ray SDK for Java JDBC interceptor will be added to th .. _Tracing calls to downstream HTTP web services with the X-Ray SDK for Java(external site): https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-java-httpclients.html .. _Apache HttpComponents(external site): https://hc.apache.org/ .. _Jersey(external site): https://eclipse-ee4j.github.io/jersey/ -.. _Client Transport Connectors(external site): https://eclipse-ee4j.github.io/jersey.github.io/documentation/latest/client.html#d0e4974 +.. _Client Transport Connectors(external site): https://eclipse-ee4j.github.io/jersey.github.io/documentation/latest/client.html#d0e5043 .. _Tracing SQL queries with the X-Ray SDK for Java(external site): https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-java-sqlclients.html .. _Intercept JDBC-Based SQL Queries(external site): https://github.com/aws/aws-xray-sdk-java#intercept-jdbc-based-sql-queries \ No newline at end of file diff --git a/en/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst b/en/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst index 8d1ce29a9..e9664ac1f 100644 --- a/en/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst +++ b/en/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst @@ -12,11 +12,11 @@ How to perform distributed tracing on Azure In Azure, distributed tracing is done using ``Azure Application Insights``. - * `Distributed tracing in Azure Application Insights (external site) `_ + * `Distributed tracing in Azure Application Insights (external site) `_ A mechanism for enabling distributed tracing from Java applications is provided by using a Java agent (**Java 3.0 agent**). - * `Azure Monitor Application Insights monitoring Java code-free applications (external site) `_ + * `Azure Monitor Application Insights monitoring Java code-free applications (external site) `_ .. important:: The Java 3.0 agent loads a large number of jar files during the initialization process. @@ -29,12 +29,12 @@ How to perform distributed tracing on Azure The following is an example of using the archetype for containers. - First, download the agent from the official website of `Azure `_. + First, download the agent from the official website of `Azure `_. Then, create an arbitrary directory under ``src/main/jib`` and store the agent. Next, place ``applicationinsights.json`` in the directory where you have just stored the agent. The ``connectionString`` is a connection string containing the instrumentation key that will be issued after the Azure Application Insights resource is created. - For other configuration options, see the `Guide `_. + For other configuration options, see the `Guide `_. * applicationinsights.json @@ -72,4 +72,4 @@ How to perform distributed tracing on Azure Now you can use ``Azure Application Insights`` for distributed tracing by building with Jib. -For detailed configuration instructions, see the `Azure documentation `_. +For detailed configuration instructions, see the `Azure documentation `_. diff --git a/en/application_framework/application_framework/libraries/bean_util.rst b/en/application_framework/application_framework/libraries/bean_util.rst index 6d9d38370..6658589bf 100644 --- a/en/application_framework/application_framework/libraries/bean_util.rst +++ b/en/application_framework/application_framework/libraries/bean_util.rst @@ -1,12 +1,12 @@ .. _bean_util: -Bean Util +BeanUtil ================================================== .. contents:: Table of contents :depth: 3 :local: -Bean Util provides the following functions related to Java Beans. +BeanUtil provides the following functions related to Java Beans. * Configuring and acquiring values for properties * Transferring values to other Java Beans diff --git a/en/application_framework/application_framework/libraries/data_io/data_format.rst b/en/application_framework/application_framework/libraries/data_io/data_format.rst index 40fe15d63..7240e6319 100644 --- a/en/application_framework/application_framework/libraries/data_io/data_format.rst +++ b/en/application_framework/application_framework/libraries/data_io/data_format.rst @@ -459,7 +459,7 @@ Use DTD with XML ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. important:: - When XML is input with this function, DTD cannot be used by default. Exceptions occur when trying to read XML that has used DTD. This is a measure to prevent `XML external entity reference (XXE) `_ . + When XML is input with this function, DTD cannot be used by default. Exceptions occur when trying to read XML that has used DTD. This is a measure to prevent `XML external entity reference (XXE) `_ . If the target XML to be read is reliable, use of DTD can be allowed using the ``allowDTD`` property of :java:extdoc:`XmlDataParser` . How to use is given below. diff --git a/en/application_framework/application_framework/libraries/database/database.rst b/en/application_framework/application_framework/libraries/database/database.rst index 718ce7176..c9dcff810 100644 --- a/en/application_framework/application_framework/libraries/database/database.rst +++ b/en/application_framework/application_framework/libraries/database/database.rst @@ -39,7 +39,8 @@ By configuring :java:extdoc:`Dialect ` corresp * A method for generating SQL statement to acquire the next value from the sequence object (:java:extdoc:`buildSequenceGeneratorSql ` ) * A method that returns :java:extdoc:`ResultSetConvertor ` , which acquires value from :java:extdoc:`ResultSet ` (:java:extdoc:`getResultSetConvertor ` ) * A method to convert search query to range specification (for paging) SQL (:java:extdoc:`convertPaginationSql ` ) -* A method for converting search query to the number acquisition SQL (:java:extdoc:`convertCountSql ` ) +* A method for converting search query to the number acquisition SQL (:java:extdoc:`convertCountSql(String) ` ) +* A method for converting SQL ID to the number acquisition SQL (:java:extdoc:`convertCountSql(String, Object, StatementFactory) ` ) * A method that returns SQL to check if :java:extdoc:`Connection ` is connected to the database (:java:extdoc:`getPingSql ` ) See :ref:`database-use_dialect` for how to configure :java:extdoc:`Dialect ` . diff --git a/en/application_framework/application_framework/libraries/database/universal_dao.rst b/en/application_framework/application_framework/libraries/database/universal_dao.rst index b2825a274..6a38f9df4 100644 --- a/en/application_framework/application_framework/libraries/database/universal_dao.rst +++ b/en/application_framework/application_framework/libraries/database/universal_dao.rst @@ -240,6 +240,10 @@ Information such as the number of search results required for displaying the pag .. tip:: Search process for paging is performed using :ref:`range specified search function of database access (JDBC wrapper) `. +.. tip:: + In paging, the number acquisition SQL is issued before the actual acquisition process of the range specified records. + If performance degradation occurs due to the number acquisition SQL, change the number acquisition SQL as necessary by referring to :ref:`universal_dao-customize_sql_for_counting`. + .. _universal_dao-generate_surrogate_key: Numbering the surrogate keys @@ -517,6 +521,78 @@ Configuration is required to use the created class. --> +.. _universal_dao-customize_sql_for_counting: + +Change the number acquisition SQL for the paging process +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +In :ref:`paging `, the number acquisition SQL is issued before the actual acquisition process of the range specified records. +By default, the number acquisition SQL is the original SQL wrapped in a ``SELECT COUNT(*) FROM`` . +If the original SQL has a heavy processing load, such as containing a ``ORDER BY`` clause, and you want to remove the ``ORDER BY`` clause to reduce the load, you can customise the dialect you are using and change the number acquisition SQL. + +.. important:: + The number acquisition SQL must have the same search conditions as the original SQL. + When preparing the number acquisition SQL, make sure that there is no difference in the search conditions between the two. + +If you want to change the number acquisition SQL, inherit the dialect used in your project and then change :java:extdoc:`Dialect#convertCountSql(String, Object, StatementFactory) ` implementation. + +Implementation examples + Below is an example of customising :java:extdoc:`nablarch.core.db.dialect.H2Dialect`. + In this example, the mapping between the original SQL and the number acquisition SQL is set in the component + and the number acquisition SQL is changed. + + .. tip:: + Appropriate mapping rules should be considered for each project. + + .. code-block:: java + + public class CustomH2Dialect extends H2Dialect { + + /** + * The mapping of the number acquisition SQL + */ + private Map sqlMap; + + /** + * {@inheritDoc} + * + * If the SQLID corresponding to {@code sqlId} exists in the mapping of the number acquisition SQL, + * it is returned as the number acquisition SQL. + */ + @Override + public String convertCountSql(String sqlId, Object params, StatementFactory statementFactory) { + + if (sqlMap.containsKey(sqlId)) { + return statementFactory.getVariableConditionSqlBySqlId(sqlMap.get(sqlId), params); + } + + return convertCountSql(statementFactory.getVariableConditionSqlBySqlId(sqlId, params)); + } + + /** + * Set the mapping of the number acquisition SQL. + * + * @param sqlMap The mapping of the number acquisition SQL + */ + public void setSqlMap(Map sqlMap){ + this.sqlMap = sqlMap; + } + } + + The customised dialect must be set in the component configuration file. + Below is an example of how a customised dialect can be configured in a component configuration file. + In this example, the mapping of the number acquisition SQL is set with the ```` element. + + .. code-block:: xml + + + + + + + + + .. _`universal_dao_jpa_annotations`: JPA annotation that can be used for Entity diff --git a/en/application_framework/application_framework/libraries/log.rst b/en/application_framework/application_framework/libraries/log.rst index c9707a4d1..0e0074945 100644 --- a/en/application_framework/application_framework/libraries/log.rst +++ b/en/application_framework/application_framework/libraries/log.rst @@ -1310,7 +1310,7 @@ The framework outputs logs based on the below output policy. Functional comparison with log4j -------------------------------------------------- -Function comparison between Nablrach and `log4j (external site) `_ are shown below. +Function comparison between Nablrach and `log4j (external site) `_ are shown below. .. list-table:: Function comparison (A: Provided B: Partially provided C: Not provided D: Not applicable) :header-rows: 1 diff --git a/en/application_framework/application_framework/libraries/mail.rst b/en/application_framework/application_framework/libraries/mail.rst index 0641bcd73..37f05ba9b 100644 --- a/en/application_framework/application_framework/libraries/mail.rst +++ b/en/application_framework/application_framework/libraries/mail.rst @@ -545,11 +545,11 @@ The following table shows the exception types and their error handling. * - Exception - Processing - * - `AddressException of JavaMail `_ when changing the email address of the send request + * - `AddressException of JavaMail `_ when changing the email address of the send request - Log output of the address that failed during conversion (log level: ERROR) * - :java:extdoc:`InvalidCharacterException` in :ref:`mail-mail_header_injection` - Log output of header string (log level: ERROR). - * - `SendFailureException of JavaMail `_ when email send fails + * - `SendFailureException of JavaMail `_ when email send fails - Log output of sent address, unsent address and invalid address (log level: ERROR) * - :java:extdoc:`Exception ` other than the above during email send - Wraps the exception and throws retry exception. diff --git a/en/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst b/en/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst index 9a2c92796..94feefd36 100644 --- a/en/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst +++ b/en/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst @@ -58,7 +58,7 @@ MOM messaging is compatible with JMS and offers :java:extdoc:`JmsMessagingProvider`. For details, refer to the linked Javadoc. -It also supports WebSphere MQ, +It also supports IBM MQ, which is widely used as a MOM. For details, see :ref:`webspheremq_adaptor`. Module list diff --git a/en/application_framework/application_framework/libraries/transaction.rst b/en/application_framework/application_framework/libraries/transaction.rst index ada0737da..568445c43 100644 --- a/en/application_framework/application_framework/libraries/transaction.rst +++ b/en/application_framework/application_framework/libraries/transaction.rst @@ -156,7 +156,7 @@ Add transaction target resource ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following steps are required to add transaction target resource. -For example, this applies when performing transaction control using IBM WebSphere MQ as a transaction manager for distributed transactions. +For example, this applies when performing transaction control using IBM MQ as a transaction manager for distributed transactions. #. Add transaction implementation #. Add a factory implementation to generate a transaction diff --git a/en/application_framework/application_framework/libraries/validation/bean_validation.rst b/en/application_framework/application_framework/libraries/validation/bean_validation.rst index 06863344f..3953135ed 100644 --- a/en/application_framework/application_framework/libraries/validation/bean_validation.rst +++ b/en/application_framework/application_framework/libraries/validation/bean_validation.rst @@ -743,8 +743,8 @@ Process to perform validation ValidatorUtil.validateWithGroup(form, SampleForm.Test1.class); -See :java:extdoc:`ValidatorUtil#validateWithGroup ` -and :java:extdoc:`ValidatorUtil#validateProperty ` for details on the APIs. +See :java:extdoc:`ValidatorUtil#validateWithGroup ` +and :java:extdoc:`ValidatorUtil#validateProperty ` for details on the APIs. .. tip:: By using the group function to switch validation rules, a single form class can be shared by multiple screens and APIs. diff --git a/en/application_framework/application_framework/messaging/mom/architecture.rst b/en/application_framework/application_framework/messaging/mom/architecture.rst index e1294a47b..aba295563 100644 --- a/en/application_framework/application_framework/messaging/mom/architecture.rst +++ b/en/application_framework/application_framework/messaging/mom/architecture.rst @@ -240,7 +240,7 @@ The minimum handler configuration for asynchronous response messaging is the sam For this reason, the registration process for the DB and queue operation must be handled as one transaction (two-phase commit control). Specifically, change the configuration of :ref:`transaction_management_handler` and replace with implementation that supports two-phase commit. - Nablarch provides an adapter for two-phase commit using WebSphere MQ. + Nablarch provides an adapter for two-phase commit using IBM MQ. For details, see :ref:`webspheremq_adaptor` . .. list-table:: Minimum handler configuration for asynchronous response messaging diff --git a/en/application_framework/application_framework/nablarch/platform.rst b/en/application_framework/application_framework/nablarch/platform.rst index 74c628e2e..3bc51c475 100644 --- a/en/application_framework/application_framework/nablarch/platform.rst +++ b/en/application_framework/application_framework/nablarch/platform.rst @@ -42,13 +42,13 @@ Test environment of Nablarch framework The Nablarch framework has been tested and verified to operate properly in the following environments. Java - * Java SE 6/7/8/11 [#java11]_/17 [#java17]_ + * Java SE 6/7/8/11 [#java11]_/17 [#java17]_/21 [#java21]_ Database * Oracle Database 12c/19c/21c/23c * IBM Db2 10.5/11.5 * SQL Server 2017/2019/2022 - * PostgreSQL 10.0/11.5/12.2/13.2/14.0/15.2 + * PostgreSQL 10.0/11.5/12.2/13.2/14.0/15.2/16.2 Application server * Oracle Weblogic Server 14.1.1 @@ -61,7 +61,7 @@ Java EE * JBeret 1.3.4.Final MOM (Message oriented middleware) - * WebSphere MQ 7 + * IBM MQ 9.3 Browser PC @@ -99,7 +99,8 @@ Application server * Apache Tomcat 6/7/8 MOM (Message oriented middleware) - * WebSphere MQ 7 + * IBM MQ 9.3 .. [#java11] When used with Java11, the configurations are required to be changed separately. For information on how to configure, see :doc:`../blank_project/setup_blankProject/setup_Java11`. .. [#java17] When used with Java17, the configurations are required to be changed separately. For information on how to configure, see :doc:`../blank_project/setup_blankProject/setup_Java17`. +.. [#java21] When used with Java21, the configurations are required to be changed separately. For information on how to configure, see :doc:`../blank_project/setup_blankProject/setup_Java21`. diff --git a/en/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst b/en/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst index a7cd42bf2..3ddec3abc 100644 --- a/en/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst +++ b/en/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst @@ -37,14 +37,14 @@ Method argument // Omitted } - * - :java:extdoc:`HttpRequest ` + * - :java:extdoc:`JaxRsHttpRequest `\ [#]_\ - When :ref:`path parameter ` and :ref:`query parameter ` are used or when the value of HTTP header is acquired, - :java:extdoc:`HttpRequest ` is defined as an argument. + :java:extdoc:`JaxRsHttpRequest ` is defined as an argument. Example: .. code-block:: java - public HttpResponse sample(HttpRequest request) { + public HttpResponse sample(JaxRsHttpRequest request) { // Omitted } @@ -66,10 +66,13 @@ Method argument .. code-block:: java - public HttpResponse sample(SampleForm form, HttpRequest request) { + public HttpResponse sample(SampleForm form, JaxRsHttpRequest request) { // Omitted } +.. [#] + HttpRequest can also be used to maintain backward compatibility, but in principle JaxRsHttpRequest should be used. + Method return value .. list-table:: :header-rows: 1 @@ -115,18 +118,18 @@ Routing Configuration Implementation of resource class methods - Acquires the path parameter from :java:extdoc:`HttpRequest ` . - For this reason, :java:extdoc:`HttpRequest ` is defined as a temporary argument for the method of the resource. + Acquires the path parameter from :java:extdoc:`JaxRsHttpRequest ` . + For this reason, :java:extdoc:`JaxRsHttpRequest ` is defined as a temporary argument for the method of the resource. - For the parameter name specified in :java:extdoc:`HttpRequest ` , + For the parameter name specified in :java:extdoc:`JaxRsHttpRequest ` , use the path parameter name specified in the routing configuration. .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public User delete(HttpRequest req) { - // Acquire the path parameter value from HttpRequest - Long id = Long.valueOf(req.getParam("id")[0]); + public User delete(JaxRsHttpRequest req) { + // Acquire the path parameter value from JaxRsHttpRequest + Long id = Long.valueOf(req.getPathParam("id")); return UniversalDao.findById(User.class, id); } @@ -153,14 +156,14 @@ Routing Configuration Implementation of resource class methods - Acquires the query parameter from :java:extdoc:`HttpRequest ` . - For this reason, :java:extdoc:`HttpRequest ` is defined as a temporary argument for the method of the resource. + Acquires the query parameter from :java:extdoc:`JaxRsHttpRequest ` . + For this reason, :java:extdoc:`JaxRsHttpRequest ` is defined as a temporary argument for the method of the resource. - Parameters acquired from :java:extdoc:`HttpRequest ` is mapped to form class using :java:extdoc:`BeanUtil `. + Parameters acquired from :java:extdoc:`JaxRsHttpRequest ` is mapped to form class using :java:extdoc:`BeanUtil `. .. code-block:: java - public HttpResponse search(HttpRequest req) { + public HttpResponse search(JaxRsHttpRequest req) { // Convert request parameters to Bean UserSearchForm form = BeanUtil.createAndCopy(UserSearchForm.class, req.getParamMap()); @@ -194,7 +197,7 @@ To create an :java:extdoc:`HttpResponse ` with a m .. code-block:: java - public HttpResponse something(HttpRequest request) { + public HttpResponse something(JaxRsHttpRequest request) { // Processing omitted. @@ -209,7 +212,7 @@ the response header cannot be specified. .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public List something(HttpRequest request, ExecutionContext context) { + public List something(JaxRsHttpRequest request, ExecutionContext context) { // Processing omitted. List clients = service.findClients(condition); @@ -224,7 +227,7 @@ It should be implemented to return an EntityResponse instead of an entity. .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public EntityResponse something(HttpRequest request, ExecutionContext context) { + public EntityResponse something(JaxRsHttpRequest request, ExecutionContext context) { // Processing omitted. List clients = service.findClients(condition); diff --git a/en/application_framework/application_framework/web_service/rest/getting_started/search/index.rst b/en/application_framework/application_framework/web_service/rest/getting_started/search/index.rst index 04e5d8f19..f4830f984 100644 --- a/en/application_framework/application_framework/web_service/rest/getting_started/search/index.rst +++ b/en/application_framework/application_framework/web_service/rest/getting_started/search/index.rst @@ -107,7 +107,7 @@ Implementation of a business action method .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public List find(HttpRequest req) { + public List find(JaxRsHttpRequest req) { // Convert request parameters to bean ProjectSearchForm form = @@ -122,7 +122,7 @@ Implementation of a business action method Key points of this implementation * Specifies ``MediaType.APPLICATION_JSON`` in :java:extdoc:`Produces` annotation to return the search results in JSON format to the client. - * Acquires the query parameter from :java:extdoc:`HttpRequest` . + * Acquires the query parameter from :java:extdoc:`JaxRsHttpRequest` . * Creates a form from the request parameters using :java:extdoc:`BeanUtil ` . * Validates form using :java:extdoc:`ValidatorUtil#validate `. * Copies the form value to the search condition bean using :java:extdoc:`BeanUtil ` . @@ -141,7 +141,7 @@ Define the mapping to the URL public class ProjectAction { @GET @Produces(MediaType.APPLICATION_JSON) - public List find(HttpRequest req) { + public List find(JaxRsHttpRequest req) { // Convert request parameters to beans ProjectSearchForm form = diff --git a/en/application_framework/example/index.rst b/en/application_framework/example/index.rst index bc3d78680..f55abb84d 100644 --- a/en/application_framework/example/index.rst +++ b/en/application_framework/example/index.rst @@ -91,3 +91,4 @@ For more information, see the description of the blank project below. * :ref:`setup_blank_project_for_Java11` * :ref:`setup_blank_project_for_Java17` +* :ref:`setup_blank_project_for_Java21` diff --git a/en/conf.py b/en/conf.py index 333c396af..6aec86d74 100644 --- a/en/conf.py +++ b/en/conf.py @@ -56,9 +56,9 @@ # built documents. # # The short X.Y version. -version = '5u23' +version = '5u24' # The full version, including alpha/beta/rc tags. -release = '5u23' +release = '5u24' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -304,14 +304,14 @@ todo_include_todos=False javadoc_url_map = { - 'nablarch' : ("https://nablarch.github.io/docs/LATEST/javadoc/", 'javadoc8'), - 'javax.persistence' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.validation' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.servlet' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.batch' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.inject' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.enterprise' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.ws' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8') + 'nablarch' : ("https://nablarch.github.io/docs/" + version + "/javadoc/", 'javadoc8'), + 'javax.persistence' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.validation' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.servlet' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.batch' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.inject' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.enterprise' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.ws' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8') } # add custom javascript @@ -322,4 +322,3 @@ def setup(app): """ extlinks = {'javadoc_url' : ('https://nablarch.github.io/docs/' + version + '/publishedApi/%s', 'path')} - diff --git a/en/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst b/en/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst index dbc53a850..15a92fc61 100644 --- a/en/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst +++ b/en/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst @@ -600,7 +600,7 @@ The following example verifies that the request parameter after execution of the HttpRequest request = testCaseInfo.getHttpRequest(); // [Description] HttpRequest after execution of the test // Request parameter should be reset - assertEquals("", request.getParam("resetparameter")); + assertEquals("", getParam(request, "resetparameter")); } }); } diff --git a/en/development_tools/testing_framework/index.rst b/en/development_tools/testing_framework/index.rst index 85fc4b5ef..3a823a7d1 100644 --- a/en/development_tools/testing_framework/index.rst +++ b/en/development_tools/testing_framework/index.rst @@ -17,7 +17,7 @@ For architects who will be adopting testing frameworks, refer to :ref:`testFWGui .. important:: The testing framework does not support the following platforms and libraries: - For this reason, testing framework such as `JUnit (external site) `_ should be used for testing applications that use these platforms and libraries. + For this reason, testing framework such as `JUnit (external site) `_ should be used for testing applications that use these platforms and libraries. * :ref:`JSR352-compliant batch application ` diff --git a/en/development_tools/toolbox/JspVerifier/JspVerifier.rst b/en/development_tools/toolbox/JspVerifier/JspVerifier.rst index 9ce79da70..108eeaaf6 100644 --- a/en/development_tools/toolbox/JspVerifier/JspVerifier.rst +++ b/en/development_tools/toolbox/JspVerifier/JspVerifier.rst @@ -36,9 +36,9 @@ Initial Environment Construction Node.js installation ========================================= -Since this tool depends on `Node.js `_ , the installer from the below site based on the environment being used is to be downloaded and installed. +Since this tool depends on `Node.js `_ , the installer from the below site based on the environment being used is to be downloaded and installed. - http://nodejs.org/ + https://nodejs.org/en Check environment variables diff --git a/en/examples/11/_images/behavior_illustration01.png b/en/examples/11/_images/behavior_illustration01.png index 02fece4a2..6cbc0b3d5 100644 Binary files a/en/examples/11/_images/behavior_illustration01.png and b/en/examples/11/_images/behavior_illustration01.png differ diff --git a/en/examples/11/_images/behavior_illustration02.png b/en/examples/11/_images/behavior_illustration02.png index bc99b345c..d6651e476 100644 Binary files a/en/examples/11/_images/behavior_illustration02.png and b/en/examples/11/_images/behavior_illustration02.png differ diff --git a/en/examples/11/fig.xlsx b/en/examples/11/fig.xlsx new file mode 100644 index 000000000..25fe03c74 Binary files /dev/null and b/en/examples/11/fig.xlsx differ diff --git a/en/examples/11/index.rst b/en/examples/11/index.rst index 58ea8b7f1..34cc08f38 100644 --- a/en/examples/11/index.rst +++ b/en/examples/11/index.rst @@ -22,6 +22,11 @@ When the simulator sends a message .. image:: ./_images/behavior_illustration02.png :scale: 70 +.. important:: + + This sample uses IBM MQ 9.3 as the MOM. + IBM MQ 9.3 supports Java version 8 or higher, so this sample uses Java 8. + Uses ---------- @@ -106,16 +111,12 @@ Getting a simulator git clone https://github.com/nablarch/nablarch-messaging-simulator.git - The following libraries must be installed in the local repository to run the simulator. - - * Jar file provided with WebSphere MQ - Creating an execution module - Execute the following command to create an execution module under ``src/main/build``. + Execute the following command to create an execution module under ``target/build``. .. code-block:: bat - gradlew setupBuild + mvn clean dependency:copy-dependencies -DoutputDirectory=target/build/lib package The created execution module is placed in the environment where the simulator is to be executed. diff --git a/en/examples/12/index.rst b/en/examples/12/index.rst index 188583b31..f61f9f3f2 100644 --- a/en/examples/12/index.rst +++ b/en/examples/12/index.rst @@ -34,7 +34,7 @@ OIDC is supported by a variety of services, but this sample deals with ID token * Microsoft Azure（hereafter referred to as "Azure"） - * `Azure Active Directory B2C `_ （hereafter referred to as "ADB2C"） + * `Azure Active Directory B2C `_ （hereafter referred to as "ADB2C"） Within the offering packages, the packages are further divided by targeted services. @@ -129,7 +129,7 @@ Although many libraries for handling JWT are available in OSS, the sample uses " .. tip:: - Libraries for working with JWT are also introduced in `OpenID Foundation `_ and `jwt.io `_ . + Libraries for working with JWT are also introduced in `OpenID Foundation `_ and `jwt.io `_ . To make the library available, add the following dependencies to dependency settings diff --git a/ja/about_nablarch/concept.rst b/ja/about_nablarch/concept.rst index d3ee3aec5..a70f0d9c2 100644 --- a/ja/about_nablarch/concept.rst +++ b/ja/about_nablarch/concept.rst @@ -28,4 +28,4 @@ Ready-to-Use そのためには、実績のある部品を再利用することが重要です。 Nablarchはこうしたニーズに応えるため、フレームワークに加えて、使用頻度の高いミドルウェア [1]_ に適合させるためのアダプタ、未経験者でもすぐに開発を始められる環境など、再利用可能なコンテンツを「すぐに使える」状態で提供します。 -.. [1] Apache Log4jやWebSphere MQなど +.. [1] Apache Log4jやIBM MQなど diff --git a/ja/application_framework/adaptors/jaxrs_adaptor.rst b/ja/application_framework/adaptors/jaxrs_adaptor.rst index aebcf7667..ef7d1e7a0 100644 --- a/ja/application_framework/adaptors/jaxrs_adaptor.rst +++ b/ja/application_framework/adaptors/jaxrs_adaptor.rst @@ -10,8 +10,8 @@ JAX-RSアダプタ :ref:`RESTfulウェブサービス ` で使用するための以下のアダプタを提供する。 * JSONを `Jackson(外部サイト、英語) `_ を使って変換するアダプタ -* `Jersey(外部サイト、英語) `_ で :ref:`RESTfulウェブサービス ` を使用するためのアダプタ -* `RESTEasy(外部サイト、英語) `_ で :ref:`RESTfulウェブサービス ` を使用するためのアダプタ +* `Jersey(外部サイト、英語) `_ で :ref:`RESTfulウェブサービス ` を使用するためのアダプタ +* `RESTEasy(外部サイト、英語) `_ で :ref:`RESTfulウェブサービス ` を使用するためのアダプタ モジュール一覧 -------------------------------------------------- @@ -55,7 +55,7 @@ JAX-RSアダプタ Jersey環境下でRESTfulウェブサービスを使用する -------------------------------------------------- ウェブアプリケーションサーバにバンドルされている `JAX-RS(外部サイト、英語) `_ の実装が、 -`Jersey(外部サイト、英語) `_ の場合には、Jersey用のアダプタを使用する。 +`Jersey(外部サイト、英語) `_ の場合には、Jersey用のアダプタを使用する。 以下にJersey用アダプタの適用方法を示す。 @@ -93,7 +93,7 @@ Jersey環境下でRESTfulウェブサービスを使用する RESTEasy環境下でRESTfulウェブサービスを使用する -------------------------------------------------- ウェブアプリケーションサーバにバンドルされている `JAX-RS(外部サイト、英語) `_ の実装が、 -`RESTEasy(外部サイト、英語) `_ の場合には、RESTEasy用のアダプタを使用する。 +`RESTEasy(外部サイト、英語) `_ の場合には、RESTEasy用のアダプタを使用する。 以下にRESTEasy用アダプタの適用方法を示す。 diff --git a/ja/application_framework/adaptors/log_adaptor.rst b/ja/application_framework/adaptors/log_adaptor.rst index a2ff7cc28..017b4eb4b 100644 --- a/ja/application_framework/adaptors/log_adaptor.rst +++ b/ja/application_framework/adaptors/log_adaptor.rst @@ -12,7 +12,7 @@ Nablarchの提供する :ref:`ログ出力機能 ` のログ出力処理を .. important:: - Nablarch5u15まで提供されていたlog4jアダプタは、EOLを迎えた `log4j1.2(外部サイト、英語) `_ を使用しており + Nablarch5u15まで提供されていたlog4jアダプタは、EOLを迎えた `log4j1.2(外部サイト、英語) `_ を使用しており `脆弱性 `_ への修正が公開されないため廃止します。 slf4jまたはJBoss Loggingを使用してください。 diff --git a/ja/application_framework/adaptors/micrometer_adaptor.rst b/ja/application_framework/adaptors/micrometer_adaptor.rst index 9585d91aa..e468e1b19 100644 --- a/ja/application_framework/adaptors/micrometer_adaptor.rst +++ b/ja/application_framework/adaptors/micrometer_adaptor.rst @@ -648,11 +648,11 @@ Azure と連携する MicrometerでメトリクスをAzureに連携する方法 Azureは、JavaアプリケーションからAzureにメトリクスを連携するための仕組みとして、Javaエージェントを用いた方法(**Java 3.0 エージェント**)を提供している。 - * `Azure Monitor Application Insights を監視する Java のコード不要のアプリケーション(外部サイト) `_ + * `Azure Monitor Application Insights を監視する Java のコード不要のアプリケーション(外部サイト) `_ このJava 3.0 エージェントは、Micrometerの `グローバルレジストリ(外部サイト、英語) `_ に出力したメトリクスを自動的に収集し、Azureに連携する仕組みを提供している。 - * `アプリケーションからカスタム テレメトリを送信する(外部サイト) `_ + * `アプリケーションからカスタム テレメトリを送信する(外部サイト) `_ .. important:: Java 3.0 エージェントは、初期化処理中に大量のjarファイルをロードする。 @@ -672,7 +672,7 @@ MicrometerアダプタでメトリクスをAzureに連携するための設定 * アプリケーションの起動オプションに、Java 3.0 エージェントを追加する * ``MeterRegistry`` にグローバルレジストリを使うようにコンポーネントを定義する - 1つ目の起動オプションの設定方法については、 `Azureのドキュメント `_ を参照のこと。 + 1つ目の起動オプションの設定方法については、 `Azureのドキュメント `_ を参照のこと。 2つ目のグローバルレジストリを使う方法について、本アダプタではグローバルレジストリのファクトリクラスとして :java:extdoc:`GlobalMeterRegistryFactory ` を用意している。 以下に、このファクトリクラスのコンポーネント定義の例を示す。 @@ -696,7 +696,7 @@ MicrometerアダプタでメトリクスをAzureに連携するための設定 メトリクスの連携は、Azureが提供するJava 3.0 エージェントによって行われる。 このため、メトリクスの連携に関する設定は全てJava 3.0 エージェントが提供する方法で行う必要がある。 - Java 3.0 エージェントの設定の詳細については、 `構成オプション(外部サイト) `_ を参照のこと。 + Java 3.0 エージェントの設定の詳細については、 `構成オプション(外部サイト) `_ を参照のこと。 .. important:: 本アダプタ用の設定ファイルである ``micrometer.properties`` は使用できないが、ファイルは配置しておく必要がある（内容は空で構わない）。 diff --git a/ja/application_framework/adaptors/router_adaptor.rst b/ja/application_framework/adaptors/router_adaptor.rst index 4df80eaf6..0b79a4b6c 100644 --- a/ja/application_framework/adaptors/router_adaptor.rst +++ b/ja/application_framework/adaptors/router_adaptor.rst @@ -217,7 +217,7 @@ XMLのマッピング定義を使用する場合は、ディスパッチハン @POST @Produces(MediaType.APPLICATION_JSON) - public int register(HttpRequest request) { + public int register(JaxRsHttpRequest request) { // 省略 } } @@ -232,7 +232,7 @@ XMLのマッピング定義を使用する場合は、ディスパッチハン パス HTTPメソッド ディスパッチされるメソッド ============ ============== ============================ ``/sample`` ``GET`` ``SampleAction#findAll()`` -``/sample`` ``POST`` ``SampleAction#register(HttpRequest)`` +``/sample`` ``POST`` ``SampleAction#register(JaxRsHttpRequest)`` ============ ============== ============================ .. tip:: @@ -273,8 +273,8 @@ XMLのマッピング定義を使用する場合は、ディスパッチハン ================ ============== ============================ パス HTTPメソッド ディスパッチされるメソッド ================ ============== ============================ -``/sample/foo`` ``GET`` ``SampleAction#findAll()`` -``/sample/bar`` ``GET`` ``SampleAction#register(HttpRequest)`` +``/sample/foo`` ``GET`` ``TestAction#foo()`` +``/sample/bar`` ``GET`` ``TestAction#bar()`` ================ ============== ============================ パスパラメータの定義 @@ -289,16 +289,16 @@ XMLのマッピング定義を使用する場合は、ディスパッチハン @GET @Path("/foo/{param}") @Produces(MediaType.APPLICATION_JSON) - public Person foo(HttpRequest request) { - String param = request.getParam("param")[0]; + public Person foo(JaxRsHttpRequest request) { + String param = request.getPathParam("param"); // 省略 } @GET @Path("/bar/{id : \\d+}") @Produces(MediaType.APPLICATION_JSON) - public Person bar(HttpRequest request) { - int id = Integer.parseInt(request.getParam("id")[0]); + public Person bar(JaxRsHttpRequest request) { + int id = Integer.parseInt(request.getPathParam("id"); // 省略 } } @@ -307,7 +307,7 @@ XMLのマッピング定義を使用する場合は、ディスパッチハン | これは、本機能（``Path`` アノテーションによるルーティング定義）がJAX-RSの仕様に準拠しているためである。 | パスの一部を ``{パラメータ名}`` と記述することで、その部分をパラメータとして定義できる。 -| ここで定義したパラメータ名を :java:extdoc:`HttpRequest#getParam(String) ` に渡すことで、パスパラメータの値を取得できる。 +| ここで定義したパラメータ名を :java:extdoc:`JaxRsHttpRequest#getPathParam(String) ` に渡すことで、パスパラメータの値を取得できる。 | さらに、 ``{パラメータ名 : 正規表現}`` と記述することで、そのパスパラメータの書式を正規表現で定義できる。 | 上記実装例では ``\\d+`` と正規表現を指定しているので、パスの値が数値のときのみメソッドがディスパッチされるようになる。 @@ -317,10 +317,10 @@ HTTPリクエストのディスパッチの例は次のようになる。 ===================== ============== ============================ パス HTTPメソッド ディスパッチされるメソッド ===================== ============== ============================ -``/sample/foo/hello`` ``GET`` ``SampleAction#foo(HttpRequest)`` -``/sample/foo/world`` ``GET`` ``SampleAction#foo(HttpRequest)`` -``/sample/bar/123`` ``GET`` ``SampleAction#bar(HttpRequest)`` -``/sample/bar/987`` ``GET`` ``SampleAction#bar(HttpRequest)`` +``/sample/foo/hello`` ``GET`` ``TestAction#foo(JaxRsHttpRequest)`` +``/sample/foo/world`` ``GET`` ``TestAction#foo(JaxRsHttpRequest)`` +``/sample/bar/123`` ``GET`` ``TestAction#bar(JaxRsHttpRequest)`` +``/sample/bar/987`` ``GET`` ``TestAction#bar(JaxRsHttpRequest)`` ===================== ============== ============================ ルーティング定義を一覧で確認する diff --git a/ja/application_framework/adaptors/webspheremq_adaptor.rst b/ja/application_framework/adaptors/webspheremq_adaptor.rst index 6850a9546..b1e821988 100644 --- a/ja/application_framework/adaptors/webspheremq_adaptor.rst +++ b/ja/application_framework/adaptors/webspheremq_adaptor.rst @@ -1,15 +1,15 @@ .. _webspheremq_adaptor: -IBM WebSphere MQアダプタ +IBM MQアダプタ ================================================== .. contents:: 目次 :depth: 3 :local: -:ref:`NablarchのMOMメッセージング機能 ` で `IBM WebSphere MQ(外部サイト、英語) `_ を使用するためのアダプタを提供する。 +:ref:`NablarchのMOMメッセージング機能 ` で `IBM MQ(外部サイト、英語) `_ を使用するためのアダプタを提供する。 -WebSphere MQの仕様及び構築手順などは、IBM社のオフィシャルサイト及びマニュアルを参照すること。 +IBM MQの仕様及び構築手順などは、IBM社のオフィシャルサイト及びマニュアルを参照すること。 モジュール一覧 -------------------------------------------------- @@ -22,8 +22,7 @@ WebSphere MQの仕様及び構築手順などは、IBM社のオフィシャル .. important:: - WebSphere MQのjarに関しては、製品マニュアルを参照し必要なものをクラスパスに追加すること。 - なおテストでは、WebSphere MQ v7.5に付属のライブラリを使用している。 + テストでは、IBM MQ 9.3のライブラリを使用している。 バージョンを変更する際には、プロジェクト側でテストを行い問題ないことを確認すること。 本アダプタを使用するための設定 @@ -38,7 +37,7 @@ WebSphere MQの仕様及び構築手順などは、IBM社のオフィシャル .. code-block:: xml - + @@ -55,7 +54,7 @@ WebSphere MQの仕様及び構築手順などは、IBM社のオフィシャル 分散トランザクションを使用する -------------------------------------------------- -本アダプタには、IBM WebSphere MQをトランザクションマネージャとして、分散トランザクションを実現する機能が含まれている。 +本アダプタには、IBM MQをトランザクションマネージャとして、分散トランザクションを実現する機能が含まれている。 この機能は、外部システムとメッセージの送受信を行う際に、取り込み漏れや2重取り込みを防止する目的で使用する。 @@ -121,7 +120,7 @@ WebSphere MQの仕様及び構築手順などは、IBM社のオフィシャル .. important:: - 分散トランザクションを使用するためには、WebSphere MQに対するXA リソース・マネージャーの設定や、データベースに対する権限付与が必要となる。 + 分散トランザクションを使用するためには、IBM MQに対するXA リソース・マネージャーの設定や、データベースに対する権限付与が必要となる。 詳細な設定方法や必要な権限などは、使用する製品のマニュアルを参照すること。 .. |br| raw:: html diff --git a/ja/application_framework/application_framework/blank_project/CustomizeDB.rst b/ja/application_framework/application_framework/blank_project/CustomizeDB.rst index bd87a7066..75bc14b3e 100644 --- a/ja/application_framework/application_framework/blank_project/CustomizeDB.rst +++ b/ja/application_framework/application_framework/blank_project/CustomizeDB.rst @@ -78,8 +78,8 @@ JDBCドライバをWebから取得する場合は、以下のサイトから入 - URL * - IBM DB2 JDBC Driver Versions |br| - and Downloads - Japan - - http://www-01.ibm.com/support/docview.wss?uid=swg21363866 (外部サイト、英語) + and Downloads + - https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads (外部サイト、英語) 以下に、入手したJDBCドライバをローカルのMavenリポジトリに登録するコマンドの例を示す。 diff --git a/ja/application_framework/application_framework/blank_project/FirstStep.rst b/ja/application_framework/application_framework/blank_project/FirstStep.rst index 970ea7491..d7b572724 100644 --- a/ja/application_framework/application_framework/blank_project/FirstStep.rst +++ b/ja/application_framework/application_framework/blank_project/FirstStep.rst @@ -12,6 +12,8 @@ setup_blankProject/setup_NablarchBatch_Dbless setup_blankProject/setup_Java11 setup_blankProject/setup_Java17 + setup_blankProject/setup_Java21 + .. toctree:: :maxdepth: 1 diff --git a/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst b/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst index 24f3877d8..f7f0a1ff9 100644 --- a/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst +++ b/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java17.rst @@ -12,6 +12,8 @@ Java17で使用する場合のセットアップ方法 * --add-opensオプションの追加（JSR352に準拠したバッチプロジェクトの場合のみ） * Javaバージョンの変更 +.. _setup_blank_project_for_Java17_add_dependencies: + 依存モジュールの追加 ------------------------------------------------------------- @@ -56,6 +58,7 @@ Java 11で、JAXBなど一部のモジュールが標準ライブラリから削 +.. _setup_blank_project_for_Java17_gsp_dba_maven_plugin: gsp-dba-maven-pluginがJava17で動くように設定する ---------------------------------------------------------- @@ -91,6 +94,7 @@ gsp-dba-maven-pluginがJava17で動くように設定する +.. _setup_blank_project_for_Java17_add_JVMoption: --add-opensオプションの追加（JSR352に準拠したバッチプロジェクトの場合のみ） ------------------------------------------------------------------------------------------------------------------ diff --git a/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst b/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst new file mode 100644 index 000000000..927db4a2b --- /dev/null +++ b/ja/application_framework/application_framework/blank_project/setup_blankProject/setup_Java21.rst @@ -0,0 +1,66 @@ +.. _setup_blank_project_for_Java21: + +---------------------------------------------------------- +Java21で使用する場合のセットアップ方法 +---------------------------------------------------------- + +ブランクプロジェクトをJava21で使用する場合、各ブランクプロジェクトの疎通確認前に以下の手順を行う。 + +* 依存モジュールの追加 +* gsp-dba-maven-pluginがJava21で動くように設定する +* 自動テストで使用するJettyのモジュール変更(ウェブプロジェクト または RESTfulウェブサービスプロジェクトの場合のみ) +* --add-opensオプションの追加（JSR352に準拠したバッチプロジェクトの場合のみ） +* 標準エンコーディングの変更（標準エンコーディングをJava17以前と同じ実行環境にしたい場合） +* Javaバージョンの変更 + +依存モジュールの追加 +------------------------------------------------------------- + +上記の手順はJava17を使用する場合と同じなので、:ref:`Java17で使用する場合のセットアップ方法 ` を参照する。 + +gsp-dba-maven-pluginがJava21で動くように設定する +---------------------------------------------------------- + +上記の手順はJava17を使用する場合と同じなので、:ref:`Java17で使用する場合のセットアップ方法 ` を参照する。 + + +自動テストで使用するJettyのモジュール変更(ウェブプロジェクト または RESTfulウェブサービスプロジェクトの場合のみ) +------------------------------------------------------------------------------------------------------------------ + +上記の手順はJava17を使用する場合と同じなので、:ref:`Java17で使用する場合のセットアップ方法 ` を参照する。 + + +--add-opensオプションの追加（JSR352に準拠したバッチプロジェクトの場合のみ） +------------------------------------------------------------------------------------------------------------------ + +上記の手順はJava17を使用する場合と同じなので、:ref:`Java17で使用する場合のセットアップ方法 ` を参照する。 + + +標準エンコーディングの変更（標準エンコーディングをJava17以前と同じく実行環境依存にしたい場合） +------------------------------------------------------------------------------------------------------------------- + +Java18から標準エンコーディングがUTF-8に統一され、環境依存ではなくなっている。 +標準エンコーディングをJava17以前と同じく実行環境依存にしたい場合は、以下のようにJavaコマンドの実行時オプションとしてシステムプロパティを指定する。 + +* ``-Dfile.encoding=COMPAT`` + +.. tip:: + Mavenから実行する場合は、環境変数 `MAVEN_OPTS (外部サイト) `_ を使うことでJVMオプションを設定できる。ただしログに ``Picked up MAVEN_OPTS: -Dfile.encoding=COMPAT`` が表示される。 + なお、MavenプラグインによってはJVMオプションの設定方法が異なる場合があるため注意すること。（例えばテストを実行するmaven-surefire-pluginでは、pom.xmlのプラグイン設定にある ``argLine`` で指定する必要がある） + +.. important:: + Java17までは ``-Dfile.encoding=COMPAT`` というオプションは有効ではないので、従来の実行環境にこのJVMオプションが適用されないように注意すること。 + +Javaバージョンの変更 +----------------------------- + +ブランクプロジェクトではソース及びclassファイルが準拠するJavaのバージョンとしてJava8が設定されているため +以下のようにファイルを変更する。 + +* pom.xml + +.. code-block:: xml + + + 21 + diff --git a/ja/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst b/ja/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst index d7875f82d..004c7b858 100644 --- a/ja/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst +++ b/ja/application_framework/application_framework/cloud_native/distributed_tracing/aws_distributed_tracing.rst @@ -330,6 +330,6 @@ Nablarchは ``dataSource`` という名前でデータソースコンポーネ .. _X-Ray SDK for Java を使用してダウンストリーム HTTP ウェブサービスの呼び出しをトレースする(外部サイト): https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/xray-sdk-java-httpclients.html .. _Apache HttpComponents(外部サイト、英語): https://hc.apache.org/ .. _Jersey(外部サイト、英語): https://eclipse-ee4j.github.io/jersey/ -.. _Client Transport Connectors(外部サイト、英語): https://eclipse-ee4j.github.io/jersey.github.io/documentation/latest/client.html#d0e4974 +.. _Client Transport Connectors(外部サイト、英語): https://eclipse-ee4j.github.io/jersey.github.io/documentation/latest/client.html#d0e5043 .. _X-Ray SDK for Java を使用して、SQL クエリをトレースする(外部サイト): https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/xray-sdk-java-sqlclients.html .. _Intercept JDBC-Based SQL Queries(外部サイト、英語): https://github.com/aws/aws-xray-sdk-java#intercept-jdbc-based-sql-queries \ No newline at end of file diff --git a/ja/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst b/ja/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst index bcf2e633f..55b324bc5 100644 --- a/ja/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst +++ b/ja/application_framework/application_framework/cloud_native/distributed_tracing/azure_distributed_tracing.rst @@ -12,11 +12,11 @@ Azureで分散トレーシングを行う方法 Azureでは、 ``Azure Application Insights`` を使用して分散トレーシングを行う。 - * `Azure Application Insights における分散トレース(外部サイト) `_ + * `Azure Application Insights における分散トレース(外部サイト) `_ Javaアプリケーションから分散トレーシングを有効化するための仕組みとして、Javaエージェントを用いた方法(**Java 3.0 エージェント**)が提供されている。 - * `Azure Monitor Application Insights を監視する Java のコード不要のアプリケーション(外部サイト) `_ + * `Azure Monitor Application Insights を監視する Java のコード不要のアプリケーション(外部サイト) `_ .. important:: Java 3.0 エージェントは、初期化処理中に大量のjarファイルをロードする。 @@ -29,12 +29,12 @@ Azureで分散トレーシングを行う方法 以下に、コンテナ用のアーキタイプを使用した場合の例を示す。 - まず、 `Azureの公式サイト `_ よりエージェントをダウンロードする。 + まず、 `Azureの公式サイト `_ よりエージェントをダウンロードする。 その後、``src/main/jib`` 以下に任意のディレクトリを作成し、エージェントを格納する。 次に、先程エージェントを格納したディレクトリに ``applicationinsights.json`` を配置する。 ``connectionString`` にはAzure Application Insightsのリソースを作成したあとに発行されるインストルメンテーションキーを含む接続文字列を指定する。 - そのほかの構成オプションについては `ガイド `_ を参照のこと。 + そのほかの構成オプションについては `ガイド `_ を参照のこと。 * applicationinsights.json @@ -73,4 +73,4 @@ Azureで分散トレーシングを行う方法 これでJibを使用してビルドすることにより、 ``Azure Application Insights`` を使用して分散トレーシングを行うことができる。 -詳細な設定方法については、 `Azureのドキュメント `_ を参照のこと。 +詳細な設定方法については、 `Azureのドキュメント `_ を参照のこと。 diff --git a/ja/application_framework/application_framework/libraries/bean_util.rst b/ja/application_framework/application_framework/libraries/bean_util.rst index d7a7e69bd..cbd0849e7 100644 --- a/ja/application_framework/application_framework/libraries/bean_util.rst +++ b/ja/application_framework/application_framework/libraries/bean_util.rst @@ -1,6 +1,6 @@ .. _bean_util: -Bean Util +BeanUtil ================================================== .. contents:: 目次 :depth: 3 diff --git a/ja/application_framework/application_framework/libraries/data_io/data_format.rst b/ja/application_framework/application_framework/libraries/data_io/data_format.rst index 09bab036d..0c6ad94f3 100644 --- a/ja/application_framework/application_framework/libraries/data_io/data_format.rst +++ b/ja/application_framework/application_framework/libraries/data_io/data_format.rst @@ -477,7 +477,7 @@ XMLでDTDを使う .. important:: 本機能でXMLを入力する場合、DTDをデフォルトで使用できない。DTDを使用したXMLを読み込もうとした場合、例外が発生する。 - これは `XML外部実体参照(XXE) `_ を防止するための措置である。 + これは `XML外部実体参照(XXE) `_ を防止するための措置である。 読み込み対象となるXMLが信頼できる場合は、 :java:extdoc:`XmlDataParser` の ``allowDTD`` プロパティを使用してDTDの使用を許可できる。 使用方法は下記の通り。 diff --git a/ja/application_framework/application_framework/libraries/database/database.rst b/ja/application_framework/application_framework/libraries/database/database.rst index bbc29a545..915b9914a 100644 --- a/ja/application_framework/application_framework/libraries/database/database.rst +++ b/ja/application_framework/application_framework/libraries/database/database.rst @@ -42,7 +42,8 @@ JDBCを使用してデータベースに対してSQL文を実行する機能を * シーケンスオブジェクトから次の値を取得するSQL文生成するメソッド(:java:extdoc:`buildSequenceGeneratorSql ` ) * :java:extdoc:`ResultSet ` から値を取得する :java:extdoc:`ResultSetConvertor ` を返すメソッド(:java:extdoc:`getResultSetConvertor ` ) * 検索クエリーを範囲指定（ページング用）SQLに変換するメソッド(:java:extdoc:`convertPaginationSql ` ) -* 検索クエリーを件数取得SQLに変換するメソッド(:java:extdoc:`convertCountSql ` ) +* 検索クエリーを件数取得SQLに変換するメソッド(:java:extdoc:`convertCountSql(String) ` ) +* SQLIDを件数取得SQLに変換するメソッド(:java:extdoc:`convertCountSql(String, Object, StatementFactory) ` ) * :java:extdoc:`Connection ` がデータベースに接続されているかチェックを行うSQLを返すメソッド(:java:extdoc:`getPingSql ` ) :java:extdoc:`Dialect ` の設定方法は、 :ref:`database-use_dialect` を参照。 diff --git a/ja/application_framework/application_framework/libraries/database/universal_dao.rst b/ja/application_framework/application_framework/libraries/database/universal_dao.rst index 9731fc744..b85b0a674 100644 --- a/ja/application_framework/application_framework/libraries/database/universal_dao.rst +++ b/ja/application_framework/application_framework/libraries/database/universal_dao.rst @@ -240,6 +240,10 @@ JDBCのフェッチサイズによってメモリの使用量が変わる。 .. tip:: ページング用の検索処理は、 :ref:`データベースアクセス(JDBCラッパー)の範囲指定検索機能 ` を使用して行う。 +.. tip:: + ページングでは、実際の範囲指定レコードの取得処理の前に、件数取得SQLが発行される。 + 件数取得SQLに起因して性能劣化が発生した場合等、必要に応じて :ref:`universal_dao-customize_sql_for_counting` を参考にして件数取得SQLを変更する。 + .. _universal_dao-generate_surrogate_key: サロゲートキーを採番する @@ -516,6 +520,77 @@ DatabaseMetaDataから情報を取得できない場合に対応する --> +.. _universal_dao-customize_sql_for_counting: + +ページング処理の件数取得用SQLを変更する +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +:ref:`ページング ` 処理では、実際の範囲指定レコードの取得処理の前に、件数取得SQLが発行される。 +件数取得SQLは、デフォルトでは元のSQLを ``SELECT COUNT(*) FROM`` で包んだSQLとなる。 +元のSQLが ``ORDER BY`` 句を含むなど処理負荷が大きいSQLで、負荷軽減のため ``ORDER BY`` 句を外したいといった場合には、 +使用しているダイアレクトをカスタマイズし、件数取得SQLを変更することで対応する。 + +.. important:: + 件数取得SQLは、元のSQLと同一の検索条件を持つ必要がある。件数取得SQLを用意する場合は、両者の検索条件に差分が発生しないよう注意すること。 + +件数取得SQLを変更する場合は、プロジェクトで使用しているダイアレクトを継承した上で、 :java:extdoc:`Dialect#convertCountSql(String, Object, StatementFactory) ` の実装を変更する。 + +実装例 + 以下に :java:extdoc:`nablarch.core.db.dialect.H2Dialect` をカスタマイズする例を示す。 + この例では、元のSQLと件数取得SQLのマッピングをコンポーネントに設定し、件数取得SQLを変更している。 + + .. tip:: + プロジェクトごとに適切なマッピングルールを検討すること。 + + .. code-block:: java + + public class CustomH2Dialect extends H2Dialect { + + /** + * 件数取得SQLのマッピング + */ + private Map sqlMap; + + /** + * {@inheritDoc} + * + * 件数取得SQLのマッピング内に{@code sqlId}に対応するSQLIDが存在すれば、 + * それを件数取得SQLとして返却する。 + */ + @Override + public String convertCountSql(String sqlId, Object params, StatementFactory statementFactory) { + + if (sqlMap.containsKey(sqlId)) { + return statementFactory.getVariableConditionSqlBySqlId(sqlMap.get(sqlId), params); + } + + return convertCountSql(statementFactory.getVariableConditionSqlBySqlId(sqlId, params)); + } + + /** + * 件数取得SQLのマッピングを設定する。 + * + * @param sqlMap 件数取得SQLのマッピング + */ + public void setSqlMap(Map sqlMap){ + this.sqlMap = sqlMap; + } + } + + カスタマイズしたダイアレクトは、コンポーネント設定ファイルで設定する必要がある。 + 以下に、カスタマイズしたダイアレクトをコンポーネント設定ファイルに設定する例を示す。 + この例では、件数取得SQLのマッピングを ```` 要素で設定している。 + + .. code-block:: xml + + + + + + + + + .. _`universal_dao_jpa_annotations`: Entityに使用できるJPAアノテーション diff --git a/ja/application_framework/application_framework/libraries/log.rst b/ja/application_framework/application_framework/libraries/log.rst index 9701212d1..eaf35c53b 100644 --- a/ja/application_framework/application_framework/libraries/log.rst +++ b/ja/application_framework/application_framework/libraries/log.rst @@ -1363,7 +1363,7 @@ LogPublisherの使い方 log4jとの機能比較 -------------------------------------------------- -ここでは、本機能と `log4j(外部サイト、英語) `_ との機能比較を示す。 +ここでは、本機能と `log4j(外部サイト、英語) `_ との機能比較を示す。 .. list-table:: 機能比較（○：提供あり　△：一部提供あり　×：提供なし　－:対象外） :header-rows: 1 diff --git a/ja/application_framework/application_framework/libraries/mail.rst b/ja/application_framework/application_framework/libraries/mail.rst index eeadc07b8..37e3faf35 100644 --- a/ja/application_framework/application_framework/libraries/mail.rst +++ b/ja/application_framework/application_framework/libraries/mail.rst @@ -545,11 +545,11 @@ * - 例外 - 処理 - * - 送信要求のメールアドレス変換時の `JavaMailのAddressException `_ + * - 送信要求のメールアドレス変換時の `JavaMailのAddressException `_ - 変換に失敗したアドレスをログ出力(ログレベル: ERROR)する。 * - :ref:`mail-mail_header_injection` での :java:extdoc:`InvalidCharacterException` - ヘッダ文字列をログ出力(ログレベル: ERROR)する。 - * - メール送信失敗時の `JavaMailのSendFailureException `_ + * - メール送信失敗時の `JavaMailのSendFailureException `_ - 送信されたアドレス、送信されなかったアドレス、不正なアドレスをログ出力(ログレベル: ERROR)する。 * - 上記以外のメール送信時の :java:extdoc:`Exception ` - 例外をラップしてリトライ例外を送出する。 diff --git a/ja/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst b/ja/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst index 5019ea1c8..17ae61918 100644 --- a/ja/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst +++ b/ja/application_framework/application_framework/libraries/system_messaging/mom_system_messaging.rst @@ -58,7 +58,7 @@ MOMメッセージングはJMSに対応しており、 :java:extdoc:`JmsMessagingProvider` を提供している。 詳細は、リンク先のJavadocを参照。 -さらに、MOMとして使用実績が多い WebSphere MQ にも対応している。 +さらに、MOMとして使用実績が多い IBM MQ にも対応している。 詳細は、 :ref:`webspheremq_adaptor` を参照。 モジュール一覧 diff --git a/ja/application_framework/application_framework/libraries/transaction.rst b/ja/application_framework/application_framework/libraries/transaction.rst index da8b0e958..3d2c5e4b2 100644 --- a/ja/application_framework/application_framework/libraries/transaction.rst +++ b/ja/application_framework/application_framework/libraries/transaction.rst @@ -156,7 +156,7 @@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ トランザクション対象のリソースを追加する場合は、以下の手順が必要となる。 -例えば、IBMのWebSphere MQを分散トランザクションのトランザクションマネージャとしてトランザクションを制御する場合などが該当する。 +例えば、IBM MQを分散トランザクションのトランザクションマネージャとしてトランザクションを制御する場合などが該当する。 #. トランザクション実装の追加 #. トランザクションを生成するためのファクトリ実装の追加 diff --git a/ja/application_framework/application_framework/libraries/validation/bean_validation.rst b/ja/application_framework/application_framework/libraries/validation/bean_validation.rst index 024379715..673432821 100644 --- a/ja/application_framework/application_framework/libraries/validation/bean_validation.rst +++ b/ja/application_framework/application_framework/libraries/validation/bean_validation.rst @@ -742,8 +742,8 @@ Nablarchでも、Bean Validationでグループ指定可能なAPIを提供して ValidatorUtil.validateWithGroup(form, SampleForm.Test1.class); -APIの詳細は、 :java:extdoc:`ValidatorUtil#validateWithGroup ` -及び :java:extdoc:`ValidatorUtil#validateProperty ` を参照。 +APIの詳細は、 :java:extdoc:`ValidatorUtil#validateWithGroup ` +及び :java:extdoc:`ValidatorUtil#validateProperty ` を参照。 .. tip:: グループ機能を使用してバリデーションのルールを切り替えることで、一つのフォームクラスを複数の画面やAPIで共通化できるようになる。 diff --git a/ja/application_framework/application_framework/messaging/mom/architecture.rst b/ja/application_framework/application_framework/messaging/mom/architecture.rst index 997afc91c..52dd42e7d 100644 --- a/ja/application_framework/application_framework/messaging/mom/architecture.rst +++ b/ja/application_framework/application_framework/messaging/mom/architecture.rst @@ -254,7 +254,7 @@ Nablarchでは、MOMメッセージングを構築するために必要なハン このため、DBに対する登録処理とキューに対する操作を1つのトランザクションとして扱う必要がある(2相コミット制御)。 具体的には、 :ref:`transaction_management_handler` の設定を変更し、2相コミットに対応した実装に差し替える必要がある。 - Nablarchでは、WebSphere MQ を使用した2相コミット用のアダプタを予め提供している。 + Nablarchでは、IBM MQ を使用した2相コミット用のアダプタを予め提供している。 詳細は、 :ref:`webspheremq_adaptor` を参照。 .. list-table:: 応答不要メッセージングの最小ハンドラ構成 diff --git a/ja/application_framework/application_framework/nablarch/platform.rst b/ja/application_framework/application_framework/nablarch/platform.rst index 6490c52f9..e4e626e57 100644 --- a/ja/application_framework/application_framework/nablarch/platform.rst +++ b/ja/application_framework/application_framework/nablarch/platform.rst @@ -43,13 +43,13 @@ Nablarchフレームワークのテスト環境 Nablarchフレームワークは、以下の環境においてテストを実施し、正常に動作することを確認している。 Java - * Java SE 6/7/8/11 [#java11]_/17 [#java17]_ + * Java SE 6/7/8/11 [#java11]_/17 [#java17]_/21 [#java21]_ データベース * Oracle Database 12c/19c/21c/23c * IBM Db2 10.5/11.5 * SQL Server 2017/2019/2022 - * PostgreSQL 10.0/11.5/12.2/13.2/14.0/15.2 + * PostgreSQL 10.0/11.5/12.2/13.2/14.0/15.2/16.2 アプリケーションサーバ * Oracle Weblogic Server 14.1.1 @@ -62,7 +62,7 @@ Java EE * JBeret 1.3.4.Final MOM（メッセージ指向ミドルウェア） - * WebSphere MQ 7 + * IBM MQ 9.3 ブラウザ PC @@ -100,7 +100,8 @@ Java * Apache Tomcat 6/7/8 MOM（メッセージ指向ミドルウェア） - * WebSphere MQ 7 + * IBM MQ 9.3 .. [#java11] Java11で使用する場合、別途設定変更が必要となる。設定方法は :doc:`../blank_project/setup_blankProject/setup_Java11` を参照。 .. [#java17] Java17で使用する場合、別途設定変更が必要となる。設定方法は :doc:`../blank_project/setup_blankProject/setup_Java17` を参照。 +.. [#java21] Java21で使用する場合、別途設定変更が必要となる。設定方法は :doc:`../blank_project/setup_blankProject/setup_Java21` を参照。 diff --git a/ja/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst b/ja/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst index 96ca2244a..c4d966c26 100644 --- a/ja/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst +++ b/ja/application_framework/application_framework/web_service/rest/feature_details/resource_signature.rst @@ -37,14 +37,14 @@ // 省略 } - * - :java:extdoc:`HttpRequest ` + * - :java:extdoc:`JaxRsHttpRequest `\ [#]_\ - :ref:`パスパラメータ ` や :ref:`クエリパラメータ ` - を使う場合やHTTPヘッダの値などを取得したい場合には、引数として :java:extdoc:`HttpRequest ` を定義する。 + を使う場合やHTTPヘッダの値などを取得したい場合には、引数として :java:extdoc:`JaxRsHttpRequest ` を定義する。 例 .. code-block:: java - public HttpResponse sample(HttpRequest request) { + public HttpResponse sample(JaxRsHttpRequest request) { // 省略 } @@ -66,10 +66,13 @@ .. code-block:: java - public HttpResponse sample(SampleForm form, HttpRequest request) { + public HttpResponse sample(SampleForm form, JaxRsHttpRequest request) { // 省略 } +.. [#] + 後方互換性維持のためHttpRequestも使用できるが、原則JaxRsHttpRequestを使用する。 + メソッド戻り値 .. list-table:: :header-rows: 1 @@ -116,18 +119,18 @@ URLの例 リソースクラスのメソッドの実装 - パスパラメータは、 :java:extdoc:`HttpRequest ` から取得する。 - このため、リソースのメソッドには、仮引数として :java:extdoc:`HttpRequest ` を定義する。 + パスパラメータは、 :java:extdoc:`JaxRsHttpRequest ` から取得する。 + このため、リソースのメソッドには、仮引数として :java:extdoc:`JaxRsHttpRequest ` を定義する。 - :java:extdoc:`HttpRequest ` に指定するパラメータ名には、 + :java:extdoc:`JaxRsHttpRequest ` に指定するパラメータ名には、 ルーティングの設定で指定したパスパラメータの名前を使用する。 .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public User delete(HttpRequest req) { - // HttpRequestからパスパラメータの値を取得する - Long id = Long.valueOf(req.getParam("id")[0]); + public User delete(JaxRsHttpRequest req) { + // JaxRsHttpRequestからパスパラメータの値を取得する + Long id = Long.valueOf(req.getPathParam("id")); return UniversalDao.findById(User.class, id); } @@ -154,14 +157,14 @@ URLの例 リソースクラスのメソッドの実装 - クエリーパラメータは、 :java:extdoc:`HttpRequest ` から取得する。 - このため、リソースのメソッドには、仮引数として :java:extdoc:`HttpRequest ` を定義する。 + クエリーパラメータは、 :java:extdoc:`JaxRsHttpRequest ` から取得する。 + このため、リソースのメソッドには、仮引数として :java:extdoc:`JaxRsHttpRequest ` を定義する。 - :java:extdoc:`HttpRequest ` から取得したパラメータを :java:extdoc:`BeanUtil ` を使ってFormクラスにマッピングする。 + :java:extdoc:`JaxRsHttpRequest ` から取得したパラメータを :java:extdoc:`BeanUtil ` を使ってFormクラスにマッピングする。 .. code-block:: java - public HttpResponse search(HttpRequest req) { + public HttpResponse search(JaxRsHttpRequest req) { // リクエストパラメータをBeanに変換 UserSearchForm form = BeanUtil.createAndCopy(UserSearchForm.class, req.getParamMap()); @@ -196,7 +199,7 @@ HttpResponseにレスポンスヘッダを指定すればよい。 .. code-block:: java - public HttpResponse something(HttpRequest request) { + public HttpResponse something(JaxRsHttpRequest request) { // 処理は省略 @@ -211,7 +214,7 @@ Producesアノテーションを使用し、リソースクラスのメソッド .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public List something(HttpRequest request, ExecutionContext context) { + public List something(JaxRsHttpRequest request, ExecutionContext context) { // 処理は省略 List clients = service.findClients(condition); @@ -226,7 +229,7 @@ Producesアノテーションを使用し、リソースクラスのメソッド .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public EntityResponse something(HttpRequest request, ExecutionContext context) { + public EntityResponse something(JaxRsHttpRequest request, ExecutionContext context) { // 処理は省略 List clients = service.findClients(condition); diff --git a/ja/application_framework/application_framework/web_service/rest/getting_started/search/index.rst b/ja/application_framework/application_framework/web_service/rest/getting_started/search/index.rst index 5dbe03a19..78a832502 100644 --- a/ja/application_framework/application_framework/web_service/rest/getting_started/search/index.rst +++ b/ja/application_framework/application_framework/web_service/rest/getting_started/search/index.rst @@ -107,7 +107,7 @@ Exampleアプリケーションを元に、検索機能を解説する。 .. code-block:: java @Produces(MediaType.APPLICATION_JSON) - public List find(HttpRequest req) { + public List find(JaxRsHttpRequest req) { // リクエストパラメータをBeanに変換 ProjectSearchForm form = @@ -123,7 +123,7 @@ Exampleアプリケーションを元に、検索機能を解説する。 この実装のポイント * 検索結果をJSON形式でクライアントに返却するため、 :java:extdoc:`Produces` アノテーションに ``MediaType.APPLICATION_JSON`` を指定する。 - * クエリパラメータは :java:extdoc:`HttpRequest` から取得する。 + * クエリパラメータは :java:extdoc:`JaxRsHttpRequest` から取得する。 * :java:extdoc:`BeanUtil ` を使用してリクエストパラメータからフォームを作成する。 * :java:extdoc:`ValidatorUtil#validate ` を使用してフォームのバリデーションを行う。 @@ -143,7 +143,7 @@ URLとのマッピングを定義 public class ProjectAction { @GET @Produces(MediaType.APPLICATION_JSON) - public List find(HttpRequest req) { + public List find(JaxRsHttpRequest req) { // リクエストパラメータをBeanに変換 ProjectSearchForm form = diff --git a/ja/application_framework/example/index.rst b/ja/application_framework/example/index.rst index d06cfe3e4..d5261de75 100644 --- a/ja/application_framework/example/index.rst +++ b/ja/application_framework/example/index.rst @@ -93,3 +93,4 @@ Java 11以上で動かす場合は、依存ライブラリの修正が必要と * :ref:`setup_blank_project_for_Java11` * :ref:`setup_blank_project_for_Java17` +* :ref:`setup_blank_project_for_Java21` diff --git a/ja/conf.py b/ja/conf.py index 129944be8..0592de250 100644 --- a/ja/conf.py +++ b/ja/conf.py @@ -56,9 +56,9 @@ # built documents. # # The short X.Y version. -version = '5u23' +version = '5u24' # The full version, including alpha/beta/rc tags. -release = '5u23' +release = '5u24' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -304,14 +304,14 @@ todo_include_todos=False javadoc_url_map = { - 'nablarch' : ("https://nablarch.github.io/docs/LATEST/javadoc/", 'javadoc8'), - 'javax.persistence' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.validation' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.servlet' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.batch' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.inject' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.enterprise' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8'), - 'javax.ws' : ('http://docs.oracle.com/javaee/7/api/', 'javadoc8') + 'nablarch' : ("https://nablarch.github.io/docs/" + version + "/javadoc/", 'javadoc8'), + 'javax.persistence' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.validation' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.servlet' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.batch' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.inject' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.enterprise' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8'), + 'javax.ws' : ('https://docs.oracle.com/javaee/7/api/', 'javadoc8') } # add custom javascript @@ -322,4 +322,3 @@ def setup(app): """ extlinks = {'javadoc_url' : ('https://nablarch.github.io/docs/' + version + '/publishedApi/%s', 'path')} - diff --git a/ja/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst b/ja/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst index 9aa07dfdd..8f62d645a 100644 --- a/ja/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst +++ b/ja/development_tools/testing_framework/guide/development_guide/05_UnitTestGuide/02_RequestUnitTest/index.rst @@ -602,7 +602,7 @@ BasicAdviceクラスには以下のメソッドが用意されており、それ HttpRequest request = testCaseInfo.getHttpRequest(); // 【説明】テスト実行後のHttpRequest // リクエストパラメータがリセットされていること - assertEquals("", request.getParam("resetparameter")); + assertEquals("", getParam(request, "resetparameter")); } }); } diff --git a/ja/development_tools/testing_framework/index.rst b/ja/development_tools/testing_framework/index.rst index a89695eb8..a5bd0652f 100644 --- a/ja/development_tools/testing_framework/index.rst +++ b/ja/development_tools/testing_framework/index.rst @@ -17,7 +17,7 @@ .. important:: テスティングフレームワークは、以下の基盤やライブラリには対応していない。 - このため、これらの基盤やライブラリを使用するアプリケーションに対するテストは、 `JUnit(外部サイト、英語) `_ などのテスティングフレームワークを使用して行うこと。 + このため、これらの基盤やライブラリを使用するアプリケーションに対するテストは、 `JUnit(外部サイト、英語) `_ などのテスティングフレームワークを使用して行うこと。 * :ref:`JSR352に準拠したバッチアプリケーション ` diff --git a/ja/development_tools/toolbox/JspVerifier/JspVerifier.rst b/ja/development_tools/toolbox/JspVerifier/JspVerifier.rst index ca2f79340..b00e2fe08 100644 --- a/ja/development_tools/toolbox/JspVerifier/JspVerifier.rst +++ b/ja/development_tools/toolbox/JspVerifier/JspVerifier.rst @@ -37,9 +37,9 @@ Node.jsのインストール ========================================= -本ツールは、 `Node.js `_ に依存しているため、下記サイトから使用する環境に合わせたインストーラをダウンロードし、インストールすること。 +本ツールは、 `Node.js `_ に依存しているため、下記サイトから使用する環境に合わせたインストーラをダウンロードし、インストールすること。 - http://nodejs.org/ + https://nodejs.org/en 環境変数の確認 diff --git a/ja/development_tools/ui_dev/doc/index.rst b/ja/development_tools/ui_dev/doc/index.rst index c01976851..682a4aac3 100644 --- a/ja/development_tools/ui_dev/doc/index.rst +++ b/ja/development_tools/ui_dev/doc/index.rst @@ -15,7 +15,7 @@ Nablarch UI開発基盤 解説書 UI開発基盤を使用する際には、以下の知識が必要となる。 これらの有識者がいない場合、UI開発基盤の使用は困難である。 - * `Node.js `_ + * `Node.js `_ * `RequireJS `_ * `jQuery `_ * `Sugar `_ diff --git a/ja/development_tools/ui_dev/index.rst b/ja/development_tools/ui_dev/index.rst index 247153451..d5b4d8858 100644 --- a/ja/development_tools/ui_dev/index.rst +++ b/ja/development_tools/ui_dev/index.rst @@ -7,7 +7,7 @@ UI開発基盤を使用する際には、以下の知識が必要となる。 これらの有識者がいない場合、UI開発基盤の使用は困難である。 - * `Node.js `_ + * `Node.js `_ * `RequireJS `_ * `jQuery `_ * `Sugar `_ diff --git a/ja/examples/11/_images/behavior_illustration01.png b/ja/examples/11/_images/behavior_illustration01.png index eaaa3df08..761169b73 100644 Binary files a/ja/examples/11/_images/behavior_illustration01.png and b/ja/examples/11/_images/behavior_illustration01.png differ diff --git a/ja/examples/11/_images/behavior_illustration02.png b/ja/examples/11/_images/behavior_illustration02.png index f0e00a5ab..0be0cc27f 100644 Binary files a/ja/examples/11/_images/behavior_illustration02.png and b/ja/examples/11/_images/behavior_illustration02.png differ diff --git a/ja/examples/11/fig.xlsx b/ja/examples/11/fig.xlsx index a7dd394f8..bcc47f191 100644 Binary files a/ja/examples/11/fig.xlsx and b/ja/examples/11/fig.xlsx differ diff --git a/ja/examples/11/index.rst b/ja/examples/11/index.rst index 452c9cd05..7549d171e 100644 --- a/ja/examples/11/index.rst +++ b/ja/examples/11/index.rst @@ -24,6 +24,11 @@ .. image:: ./_images/behavior_illustration02.png :scale: 70 +.. important:: + + 本サンプルではMOMとしてIBM MQ 9.3 を使用している。 + IBM MQ 9.3 はJavaのバージョン 8 以上がサポート対象であるため、本サンプルでは Java 8を使用する。 + 用途 ---------- @@ -109,16 +114,12 @@ Nablarchアプリケーションフレームワークのマルチスレッド実 git clone https://github.com/nablarch/nablarch-messaging-simulator.git - なお、シミュレータを実行するには、以下のライブラリがローカルリポジトリにインストールされている必要がある。 - - * WebSphere MQ付属のjarファイル - 実行モジュールの作成 - 以下のコマンドを実行し、 ``src/main/build`` 配下に実行モジュールを作成する。 + 以下のコマンドを実行し、 ``target/build`` 配下に実行モジュールを作成する。 .. code-block:: bat - gradlew setupBuild + mvn clean dependency:copy-dependencies -DoutputDirectory=target/build/lib package 作成した実行モジュールは、シミュレータを実行する環境に配置する。 diff --git a/ja/examples/12/index.rst b/ja/examples/12/index.rst index 4329f2010..8f6e9cc26 100644 --- a/ja/examples/12/index.rst +++ b/ja/examples/12/index.rst @@ -34,7 +34,7 @@ OIDCは様々なサービスで対応しているが、本サンプルでは以 * Microsoft Azure（以下Azure） - * `Azure Active Directory B2C `_ （以下ADB2C） + * `Azure Active Directory B2C `_ （以下ADB2C） 提供パッケージ内では、対象のサービス別にさらにパッケージを分けている。 @@ -129,7 +129,7 @@ JWTを扱うためのライブラリはOSSでも多く公開されているが .. tip:: - JWTを扱うライブラリは、 `OpenID Foundation `_ や `jwt.io `_ でも紹介されている。 + JWTを扱うライブラリは、 `OpenID Foundation `_ や `jwt.io `_ でも紹介されている。 ライブラリを使用可能にするため、プロジェクトの依存関係設定に以下の依存関係を追加する。 diff --git a/ja/extension_components/report/index.rst b/ja/extension_components/report/index.rst index 58359094d..4ded6c986 100644 --- a/ja/extension_components/report/index.rst +++ b/ja/extension_components/report/index.rst @@ -12,7 +12,7 @@ JasperReportsのバージョンについて -URL: 　https://community.jaspersoft.com/project/jasperreports-library +URL: 　https://community.jaspersoft.com/downloads/community-edition/ (2014/12/16時点) ================ ================== =================== diff --git a/ja/extension_components/workflow/doc/index.rst b/ja/extension_components/workflow/doc/index.rst index cf0dff927..d677dd945 100644 --- a/ja/extension_components/workflow/doc/index.rst +++ b/ja/extension_components/workflow/doc/index.rst @@ -156,7 +156,7 @@ BPMNのモデリングは、以下の製品などで行える。 - * https://camunda.org/ + * https://camunda.com/ .. _workflow-start: diff --git a/ja/releases/index.rst b/ja/releases/index.rst index 27a291a26..c10845016 100644 --- a/ja/releases/index.rst +++ b/ja/releases/index.rst @@ -16,6 +16,10 @@ - バージョン - リリースノート - ドキュメント + * - 2024/3/15 + - 5u24 + - :download:`リリースノート(5u24) <./nablarch5u24-releasenote.xlsx>` + - `ドキュメント(5u24) `_ * - 2023/9/27 - 5u23 - :download:`リリースノート(5u23) <./nablarch5u23-releasenote.xlsx>` diff --git a/ja/releases/nablarch-5-OSS-all-releasenote.zip b/ja/releases/nablarch-5-OSS-all-releasenote.zip index 72de9cc0e..a6552ff9b 100644 Binary files a/ja/releases/nablarch-5-OSS-all-releasenote.zip and b/ja/releases/nablarch-5-OSS-all-releasenote.zip differ diff --git a/ja/releases/nablarch5u10-releasenote.xlsx b/ja/releases/nablarch5u10-releasenote.xlsx index bb42b8cff..6bd0075b0 100644 Binary files a/ja/releases/nablarch5u10-releasenote.xlsx and b/ja/releases/nablarch5u10-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u11-releasenote.xlsx b/ja/releases/nablarch5u11-releasenote.xlsx index 542579f20..63b865959 100644 Binary files a/ja/releases/nablarch5u11-releasenote.xlsx and b/ja/releases/nablarch5u11-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u12-releasenote.xlsx b/ja/releases/nablarch5u12-releasenote.xlsx index b37446c79..b1d940d86 100644 Binary files a/ja/releases/nablarch5u12-releasenote.xlsx and b/ja/releases/nablarch5u12-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u13-releasenote.xlsx b/ja/releases/nablarch5u13-releasenote.xlsx index 0e0e7cb52..8a0fd45b1 100644 Binary files a/ja/releases/nablarch5u13-releasenote.xlsx and b/ja/releases/nablarch5u13-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u14-releasenote.xlsx b/ja/releases/nablarch5u14-releasenote.xlsx index aa30a8441..78b5070c4 100644 Binary files a/ja/releases/nablarch5u14-releasenote.xlsx and b/ja/releases/nablarch5u14-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u15-releasenote.xlsx b/ja/releases/nablarch5u15-releasenote.xlsx index 3c1dfdbea..4d78dc542 100644 Binary files a/ja/releases/nablarch5u15-releasenote.xlsx and b/ja/releases/nablarch5u15-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u16-releasenote.xlsx b/ja/releases/nablarch5u16-releasenote.xlsx index 0dda85807..ea73c1a11 100644 Binary files a/ja/releases/nablarch5u16-releasenote.xlsx and b/ja/releases/nablarch5u16-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u17-releasenote.xlsx b/ja/releases/nablarch5u17-releasenote.xlsx index cc0a918d8..cc2dcd67e 100644 Binary files a/ja/releases/nablarch5u17-releasenote.xlsx and b/ja/releases/nablarch5u17-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u18-releasenote.xlsx b/ja/releases/nablarch5u18-releasenote.xlsx index d53caa694..1e343ad76 100644 Binary files a/ja/releases/nablarch5u18-releasenote.xlsx and b/ja/releases/nablarch5u18-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u19-releasenote.xlsx b/ja/releases/nablarch5u19-releasenote.xlsx index d40ce3143..4515c2d4f 100644 Binary files a/ja/releases/nablarch5u19-releasenote.xlsx and b/ja/releases/nablarch5u19-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u20-releasenote.xlsx b/ja/releases/nablarch5u20-releasenote.xlsx index 659458258..c055b41bd 100644 Binary files a/ja/releases/nablarch5u20-releasenote.xlsx and b/ja/releases/nablarch5u20-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u21-releasenote.xlsx b/ja/releases/nablarch5u21-releasenote.xlsx index 5ea897d55..db5ba7b1c 100644 Binary files a/ja/releases/nablarch5u21-releasenote.xlsx and b/ja/releases/nablarch5u21-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u22-releasenote.xlsx b/ja/releases/nablarch5u22-releasenote.xlsx index a75bf1cd0..a24e2b0a3 100644 Binary files a/ja/releases/nablarch5u22-releasenote.xlsx and b/ja/releases/nablarch5u22-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u23-releasenote.xlsx b/ja/releases/nablarch5u23-releasenote.xlsx index 8543ed207..9702d3555 100644 Binary files a/ja/releases/nablarch5u23-releasenote.xlsx and b/ja/releases/nablarch5u23-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u24-releasenote.xlsx b/ja/releases/nablarch5u24-releasenote.xlsx new file mode 100644 index 000000000..496eaba13 Binary files /dev/null and b/ja/releases/nablarch5u24-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u6-releasenote.xlsx b/ja/releases/nablarch5u6-releasenote.xlsx index c704e80a3..f60b545b6 100644 Binary files a/ja/releases/nablarch5u6-releasenote.xlsx and b/ja/releases/nablarch5u6-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u7-releasenote.xlsx b/ja/releases/nablarch5u7-releasenote.xlsx index d140312fd..c6c960310 100644 Binary files a/ja/releases/nablarch5u7-releasenote.xlsx and b/ja/releases/nablarch5u7-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u8-releasenote.xlsx b/ja/releases/nablarch5u8-releasenote.xlsx index 76a63f655..35b76f6ef 100644 Binary files a/ja/releases/nablarch5u8-releasenote.xlsx and b/ja/releases/nablarch5u8-releasenote.xlsx differ diff --git a/ja/releases/nablarch5u9-releasenote.xlsx b/ja/releases/nablarch5u9-releasenote.xlsx index ef7a912ac..10b74e1e5 100644 Binary files a/ja/releases/nablarch5u9-releasenote.xlsx and b/ja/releases/nablarch5u9-releasenote.xlsx differ