HHH-18497 Add xmlquery function

beikov · beikov · commit 449d002563cb · 2024-09-23T15:03:22.000+02:00
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/hql/QueryLanguage.adoc b/documentation/src/main/asciidoc/userguide/chapters/query/hql/QueryLanguage.adoc
@@ -2176,6 +2176,7 @@ it is necessary to enable the `hibernate.query.hql.xml_functions_enabled` config
 | `xmlforest()` | Constructs an XML forest from the arguments
 | `xmlconcat()` | Concatenates multiple XML fragments to each other
 | `xmlpi()` | Constructs an XML processing instruction
+| `xmlquery()` | Extracts content from XML document using XQuery or XPath
 |===
 
 
@@ -2300,6 +2301,30 @@ include::{xml-example-dir-hql}/XmlPiTest.java[tags=hql-xmlpi-content-example]
 
 WARNING: SAP HANA, MySQL, MariaDB and HSQLDB do not support this function.
 
+[[hql-xmlquery-function]]
+===== `xmlquery()`
+
+Extracts content from an XML document using XQuery or XPath.
+
+[[hql-xmlquery-bnf]]
+[source, antlrv4, indent=0]
+----
+include::{extrasdir}/xmlquery_bnf.txt[]
+----
+
+The first argument represents the XQuery or XPath expression.
+The second argument after the `passing` keyword represents the XML document.
+
+[[hql-xmlquery-example]]
+====
+[source, java, indent=0]
+----
+include::{xml-example-dir-hql}/XmlQueryTest.java[tags=hql-xmlquery-example]
+----
+====
+
+WARNING: SAP HANA, MySQL, MariaDB and HSQLDB do not support this function.
+
 [[hql-user-defined-functions]]
 ==== Native and user-defined functions
 
diff --git a/documentation/src/main/asciidoc/userguide/chapters/query/hql/extras/xmlquery_bnf.txt b/documentation/src/main/asciidoc/userguide/chapters/query/hql/extras/xmlquery_bnf.txt
@@ -0,0 +1 @@
+"xmlquery(" expression "passing" expression ")"
diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/DB2LegacyDialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/DB2LegacyDialect.java
@@ -446,6 +446,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_db2();
 	}
 
 	@Override
diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/OracleLegacyDialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/OracleLegacyDialect.java
@@ -331,6 +331,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_oracle();
 	}
 
 	@Override
diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java
@@ -674,6 +674,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_postgresql();
 
 		if ( getVersion().isSameOrAfter( 9, 4 ) ) {
 			functionFactory.makeDateTimeTimestamp();
diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/SQLServerLegacyDialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/SQLServerLegacyDialect.java
@@ -418,6 +418,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest_sqlserver();
 		functionFactory.xmlconcat_sqlserver();
 		functionFactory.xmlpi_sqlserver();
+		functionFactory.xmlquery_sqlserver();
 		if ( getVersion().isSameOrAfter( 14 ) ) {
 			functionFactory.listagg_stringAggWithinGroup( "varchar(max)" );
 			functionFactory.jsonArrayAgg_sqlserver( getVersion().isSameOrAfter( 16 ) );
diff --git a/hibernate-core/src/main/antlr/org/hibernate/grammars/hql/HqlLexer.g4 b/hibernate-core/src/main/antlr/org/hibernate/grammars/hql/HqlLexer.g4
@@ -334,6 +334,7 @@ XMLATTRIBUTES		: [xX] [mM] [lL] [aA] [tT] [tT] [rR] [iI] [bB] [uU] [tT] [eE] [sS
 XMLELEMENT			: [xX] [mM] [lL] [eE] [lL] [eE] [mM] [eE] [nN] [tT];
 XMLFOREST			: [xX] [mM] [lL] [fF] [oO] [rR] [eE] [sS] [tT];
 XMLPI				: [xX] [mM] [lL] [pP] [iI];
+XMLQUERY			: [xX] [mM] [lL] [qQ] [uU] [eE] [rR] [yY];
 YEAR				: [yY] [eE] [aA] [rR];
 ZONED				: [zZ] [oO] [nN] [eE] [dD];
 
diff --git a/hibernate-core/src/main/antlr/org/hibernate/grammars/hql/HqlParser.g4 b/hibernate-core/src/main/antlr/org/hibernate/grammars/hql/HqlParser.g4
@@ -1721,6 +1721,7 @@ xmlFunction
 	: xmlelementFunction
 	| xmlforestFunction
 	| xmlpiFunction
+	| xmlqueryFunction
 	;
 
 /**
@@ -1751,6 +1752,13 @@ xmlpiFunction
 	: XMLPI LEFT_PAREN NAME identifier (COMMA expression)? RIGHT_PAREN
 	;
 
+/**
+ * The 'xmlquery()' function
+ */
+xmlqueryFunction
+	: XMLQUERY LEFT_PAREN expression PASSING expression RIGHT_PAREN
+	;
+
 /**
  * Support for "soft" keywords which may be used as identifiers
  *
@@ -1961,6 +1969,7 @@ xmlpiFunction
 	| XMLELEMENT
 	| XMLFOREST
 	| XMLPI
+	| XMLQUERY
 	| YEAR
 	| ZONED) {
 		logUseOfReservedWordAsIdentifier( getCurrentToken() );
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/DB2Dialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/DB2Dialect.java
@@ -431,6 +431,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_db2();
 	}
 
 	@Override
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/OracleDialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/OracleDialect.java
@@ -421,6 +421,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_oracle();
 	}
 
 	@Override
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java
@@ -635,6 +635,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest();
 		functionFactory.xmlconcat();
 		functionFactory.xmlpi();
+		functionFactory.xmlquery_postgresql();
 
 		functionFactory.makeDateTimeTimestamp();
 		// Note that PostgreSQL doesn't support the OVER clause for ordered set-aggregate functions
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/SQLServerDialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/SQLServerDialect.java
@@ -436,6 +436,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.xmlforest_sqlserver();
 		functionFactory.xmlconcat_sqlserver();
 		functionFactory.xmlpi_sqlserver();
+		functionFactory.xmlquery_sqlserver();
 		if ( getVersion().isSameOrAfter( 14 ) ) {
 			functionFactory.listagg_stringAggWithinGroup( "varchar(max)" );
 			functionFactory.jsonArrayAgg_sqlserver( getVersion().isSameOrAfter( 16 ) );
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/function/CommonFunctionFactory.java b/hibernate-core/src/main/java/org/hibernate/dialect/function/CommonFunctionFactory.java
@@ -157,14 +157,17 @@
 import org.hibernate.dialect.function.xml.H2XmlElementFunction;
 import org.hibernate.dialect.function.xml.H2XmlForestFunction;
 import org.hibernate.dialect.function.xml.H2XmlPiFunction;
+import org.hibernate.dialect.function.xml.PostgreSQLXmlQueryFunction;
 import org.hibernate.dialect.function.xml.SQLServerXmlConcatFunction;
 import org.hibernate.dialect.function.xml.SQLServerXmlElementFunction;
 import org.hibernate.dialect.function.xml.SQLServerXmlForestFunction;
 import org.hibernate.dialect.function.xml.SQLServerXmlPiFunction;
+import org.hibernate.dialect.function.xml.SQLServerXmlQueryFunction;
 import org.hibernate.dialect.function.xml.XmlConcatFunction;
 import org.hibernate.dialect.function.xml.XmlElementFunction;
 import org.hibernate.dialect.function.xml.XmlForestFunction;
 import org.hibernate.dialect.function.xml.XmlPiFunction;
+import org.hibernate.dialect.function.xml.XmlQueryFunction;
 import org.hibernate.query.sqm.function.SqmFunctionRegistry;
 import org.hibernate.query.sqm.produce.function.ArgumentTypesValidator;
 import org.hibernate.query.sqm.produce.function.FunctionParameterType;
@@ -4215,4 +4218,32 @@ public void xmlpi_h2() {
 	public void xmlpi_sqlserver() {
 		functionRegistry.register( "xmlpi", new SQLServerXmlPiFunction( typeConfiguration ) );
 	}
+
+	/**
+	 * Oracle xmlquery() function
+	 */
+	public void xmlquery_oracle() {
+		functionRegistry.register( "xmlquery", new XmlQueryFunction( true, typeConfiguration ) );
+	}
+
+	/**
+	 * DB2 xmlquery() function
+	 */
+	public void xmlquery_db2() {
+		functionRegistry.register( "xmlquery", new XmlQueryFunction( false, typeConfiguration ) );
+	}
+
+	/**
+	 * PostgreSQL xmlquery() function
+	 */
+	public void xmlquery_postgresql() {
+		functionRegistry.register( "xmlquery", new PostgreSQLXmlQueryFunction( typeConfiguration ) );
+	}
+
+	/**
+	 * SQL Server xmlquery() function
+	 */
+	public void xmlquery_sqlserver() {
+		functionRegistry.register( "xmlquery", new SQLServerXmlQueryFunction( typeConfiguration ) );
+	}
 }
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/function/json/ExpressionTypeHelper.java b/hibernate-core/src/main/java/org/hibernate/dialect/function/json/ExpressionTypeHelper.java
@@ -35,6 +35,13 @@ public static boolean isJson(SqlAstNode node) {
 				&& expressionType.getSingleJdbcMapping().getJdbcType().isJson();
 	}
 
+	public static boolean isXml(SqlAstNode node) {
+		final Expression expression = (Expression) node;
+		final JdbcMappingContainer expressionType = expression.getExpressionType();
+		return expressionType.getJdbcTypeCount() == 1
+				&& expressionType.getSingleJdbcMapping().getJdbcType().isXml();
+	}
+
 	public static JdbcType getSingleJdbcType(SqlAstNode node) {
 		final Expression expression = (Expression) node;
 		final JdbcMappingContainer expressionType = expression.getExpressionType();
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/PostgreSQLXmlQueryFunction.java b/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/PostgreSQLXmlQueryFunction.java
@@ -0,0 +1,46 @@
+/*
+ * SPDX-License-Identifier: LGPL-2.1-or-later
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+package org.hibernate.dialect.function.xml;
+
+import java.util.List;
+
+import org.hibernate.dialect.function.json.ExpressionTypeHelper;
+import org.hibernate.query.ReturnableType;
+import org.hibernate.sql.ast.SqlAstTranslator;
+import org.hibernate.sql.ast.spi.SqlAppender;
+import org.hibernate.sql.ast.tree.SqlAstNode;
+import org.hibernate.sql.ast.tree.expression.Expression;
+import org.hibernate.type.spi.TypeConfiguration;
+
+/**
+ * PostgreSQL xmlquery function.
+ */
+public class PostgreSQLXmlQueryFunction extends XmlQueryFunction {
+
+	public PostgreSQLXmlQueryFunction(TypeConfiguration typeConfiguration) {
+		super( false, typeConfiguration );
+	}
+
+	@Override
+	public void render(
+			SqlAppender sqlAppender,
+			List<? extends SqlAstNode> sqlAstArguments,
+			ReturnableType<?> returnType,
+			SqlAstTranslator<?> walker) {
+		final Expression xmlDocument = (Expression) sqlAstArguments.get( 1 );
+		final boolean needsCast = !ExpressionTypeHelper.isXml( xmlDocument );
+		sqlAppender.appendSql( "(select xmlagg(v) from unnest(xpath(" );
+		sqlAstArguments.get( 0 ).accept( walker );
+		sqlAppender.appendSql( ',' );
+		if ( needsCast ) {
+			sqlAppender.appendSql( "cast(" );
+		}
+		sqlAstArguments.get( 1 ).accept( walker );
+		if ( needsCast ) {
+			sqlAppender.appendSql( " as xml)" );
+		}
+		sqlAppender.appendSql( ")) t(v))" );
+	}
+}
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/SQLServerXmlQueryFunction.java b/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/SQLServerXmlQueryFunction.java
@@ -0,0 +1,45 @@
+/*
+ * SPDX-License-Identifier: LGPL-2.1-or-later
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+package org.hibernate.dialect.function.xml;
+
+import java.util.List;
+
+import org.hibernate.dialect.function.json.ExpressionTypeHelper;
+import org.hibernate.query.ReturnableType;
+import org.hibernate.sql.ast.SqlAstTranslator;
+import org.hibernate.sql.ast.spi.SqlAppender;
+import org.hibernate.sql.ast.tree.SqlAstNode;
+import org.hibernate.sql.ast.tree.expression.Expression;
+import org.hibernate.type.spi.TypeConfiguration;
+
+/**
+ * SQL Server xmlquery function.
+ */
+public class SQLServerXmlQueryFunction extends XmlQueryFunction {
+
+	public SQLServerXmlQueryFunction(TypeConfiguration typeConfiguration) {
+		super( false, typeConfiguration );
+	}
+
+	@Override
+	public void render(
+			SqlAppender sqlAppender,
+			List<? extends SqlAstNode> sqlAstArguments,
+			ReturnableType<?> returnType,
+			SqlAstTranslator<?> walker) {
+		final Expression xmlDocument = (Expression) sqlAstArguments.get( 1 );
+		final boolean needsCast = !ExpressionTypeHelper.isXml( xmlDocument );
+		if ( needsCast ) {
+			sqlAppender.appendSql( "cast(" );
+		}
+		sqlAstArguments.get( 1 ).accept( walker );
+		if ( needsCast ) {
+			sqlAppender.appendSql( " as xml)" );
+		}
+		sqlAppender.appendSql( ".query(" );
+		sqlAstArguments.get( 0 ).accept( walker );
+		sqlAppender.appendSql( ')' );
+	}
+}
diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/XmlQueryFunction.java b/hibernate-core/src/main/java/org/hibernate/dialect/function/xml/XmlQueryFunction.java
@@ -0,0 +1,73 @@
+/*
+ * SPDX-License-Identifier: LGPL-2.1-or-later
+ * Copyright Red Hat Inc. and Hibernate Authors
+ */
+package org.hibernate.dialect.function.xml;
+
+import java.util.List;
+
+import org.hibernate.dialect.function.json.ExpressionTypeHelper;
+import org.hibernate.query.ReturnableType;
+import org.hibernate.query.sqm.function.AbstractSqmSelfRenderingFunctionDescriptor;
+import org.hibernate.query.sqm.function.FunctionKind;
+import org.hibernate.query.sqm.produce.function.ArgumentTypesValidator;
+import org.hibernate.query.sqm.produce.function.StandardArgumentsValidators;
+import org.hibernate.query.sqm.produce.function.StandardFunctionArgumentTypeResolvers;
+import org.hibernate.query.sqm.produce.function.StandardFunctionReturnTypeResolvers;
+import org.hibernate.sql.ast.SqlAstTranslator;
+import org.hibernate.sql.ast.spi.SqlAppender;
+import org.hibernate.sql.ast.tree.SqlAstNode;
+import org.hibernate.sql.ast.tree.expression.Expression;
+import org.hibernate.type.SqlTypes;
+import org.hibernate.type.spi.TypeConfiguration;
+
+import static org.hibernate.query.sqm.produce.function.FunctionParameterType.IMPLICIT_XML;
+import static org.hibernate.query.sqm.produce.function.FunctionParameterType.STRING;
+import static org.hibernate.query.sqm.produce.function.FunctionParameterType.XML;
+
+/**
+ * Standard xmlquery function.
+ */
+public class XmlQueryFunction extends AbstractSqmSelfRenderingFunctionDescriptor {
+
+	private final boolean returningContent;
+
+	public XmlQueryFunction(boolean returningContent, TypeConfiguration typeConfiguration) {
+		super(
+				"xmlquery",
+				FunctionKind.NORMAL,
+				StandardArgumentsValidators.composite(
+						new ArgumentTypesValidator( null, STRING, IMPLICIT_XML )
+				),
+				StandardFunctionReturnTypeResolvers.invariant(
+						typeConfiguration.getBasicTypeRegistry().resolve( String.class, SqlTypes.SQLXML )
+				),
+				StandardFunctionArgumentTypeResolvers.invariant( typeConfiguration, STRING, XML )
+		);
+		this.returningContent = returningContent;
+	}
+
+	@Override
+	public void render(
+			SqlAppender sqlAppender,
+			List<? extends SqlAstNode> sqlAstArguments,
+			ReturnableType<?> returnType,
+			SqlAstTranslator<?> walker) {
+		final Expression xmlDocument = (Expression) sqlAstArguments.get( 1 );
+		final boolean needsCast = !ExpressionTypeHelper.isXml( xmlDocument );
+		sqlAppender.appendSql( "xmlquery(" );
+		sqlAstArguments.get( 0 ).accept( walker );
+		sqlAppender.appendSql( " passing " );
+		if ( needsCast ) {
+			sqlAppender.appendSql( "xmlparse(document " );
+		}
+		sqlAstArguments.get( 1 ).accept( walker );
+		if ( needsCast ) {
+			sqlAppender.appendSql( ')' );
+		}
+		if ( returningContent ) {
+			sqlAppender.appendSql( " returning content" );
+		}
+		sqlAppender.appendSql( ')' );
+	}
+}
diff --git a/hibernate-core/src/main/java/org/hibernate/query/criteria/HibernateCriteriaBuilder.java b/hibernate-core/src/main/java/org/hibernate/query/criteria/HibernateCriteriaBuilder.java
@@ -4113,6 +4113,22 @@ default <E> JpaPredicate collectionOverlapsNullable(Collection<E> collection1, E
 	@Incubating
 	JpaExpression<String> xmlpi(String elementName, Expression<String> content);
 
+	/**
+	 * Queries the given XML document with the given XPath or XQuery query.
+	 *
+	 * @since 7.0
+	 */
+	@Incubating
+	JpaExpression<String> xmlquery(String query, Expression<?> xmlDocument);
+
+	/**
+	 * Queries the given XML document with the given XPath or XQuery query.
+	 *
+	 * @since 7.0
+	 */
+	@Incubating
+	JpaExpression<String> xmlquery(Expression<String> query, Expression<?> xmlDocument);
+
 	/**
 	 * Creates a named expression. The name is important for the result of the expression,
 	 * e.g. when building an {@code xmlforest}, the name acts as the XML element name.
diff --git a/hibernate-core/src/main/java/org/hibernate/query/criteria/spi/HibernateCriteriaBuilderDelegate.java b/hibernate-core/src/main/java/org/hibernate/query/criteria/spi/HibernateCriteriaBuilderDelegate.java
diff --git a/hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java b/hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java
diff --git a/hibernate-core/src/main/java/org/hibernate/query/sqm/NodeBuilder.java b/hibernate-core/src/main/java/org/hibernate/query/sqm/NodeBuilder.java
diff --git a/hibernate-core/src/main/java/org/hibernate/query/sqm/internal/SqmCriteriaNodeBuilder.java b/hibernate-core/src/main/java/org/hibernate/query/sqm/internal/SqmCriteriaNodeBuilder.java
diff --git a/hibernate-core/src/test/java/org/hibernate/orm/test/function/xml/XmlQueryTest.java b/hibernate-core/src/test/java/org/hibernate/orm/test/function/xml/XmlQueryTest.java
diff --git a/hibernate-core/src/test/java/org/hibernate/orm/test/query/hql/XmlFunctionTests.java b/hibernate-core/src/test/java/org/hibernate/orm/test/query/hql/XmlFunctionTests.java
diff --git a/hibernate-testing/src/main/java/org/hibernate/testing/orm/junit/DialectFeatureChecks.java b/hibernate-testing/src/main/java/org/hibernate/testing/orm/junit/DialectFeatureChecks.java

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+"xmlquery(" expression "passing" expression ")"`
Original file line number	Diff line number	Diff line change
`@@ -446,6 +446,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio`
`446`	`446`	`functionFactory.xmlforest();`
`447`	`447`	`functionFactory.xmlconcat();`
`448`	`448`	`functionFactory.xmlpi();`
	`449`	`+ functionFactory.xmlquery_db2();`
`449`	`450`	`}`
`450`	`451`
`451`	`452`	`@Override`
Original file line number	Diff line number	Diff line change
`@@ -331,6 +331,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio`
`331`	`331`	`functionFactory.xmlforest();`
`332`	`332`	`functionFactory.xmlconcat();`
`333`	`333`	`functionFactory.xmlpi();`
	`334`	`+ functionFactory.xmlquery_oracle();`
`334`	`335`	`}`
`335`	`336`
`336`	`337`	`@Override`
Original file line number	Diff line number	Diff line change
`@@ -431,6 +431,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio`
`431`	`431`	`functionFactory.xmlforest();`
`432`	`432`	`functionFactory.xmlconcat();`
`433`	`433`	`functionFactory.xmlpi();`
	`434`	`+ functionFactory.xmlquery_db2();`
`434`	`435`	`}`
`435`	`436`
`436`	`437`	`@Override`
Original file line number	Diff line number	Diff line change
`@@ -421,6 +421,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio`
`421`	`421`	`functionFactory.xmlforest();`
`422`	`422`	`functionFactory.xmlconcat();`
`423`	`423`	`functionFactory.xmlpi();`
	`424`	`+ functionFactory.xmlquery_oracle();`
`424`	`425`	`}`
`425`	`426`
`426`	`427`	`@Override`