com.marklogic.client.query.StructuredQueryDefinition Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of marklogic-client-api Show documentation

The official MarkLogic Java client API.

The newest version!

/*
 * Copyright © 2024 MarkLogic Corporation. All Rights Reserved.
 */
package com.marklogic.client.query;

import com.marklogic.client.pojo.PojoQueryDefinition;

import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamWriter;

/**
 * A StructuredQueryDefinition represents a structured query.
 *
 * Instances of this interface are produced by StructuredQueryBuilder.
 */
public interface StructuredQueryDefinition
  extends QueryDefinition, ValueQueryDefinition, PojoQueryDefinition
{
	/**
	 * Returns the structured query definition as a serialized XML string.
	 *
	 * @return The serialized definition.
	 */
	String serialize();

	/**
	 * Serializes the structured query definition to the given XML stream writer. To ensure that the query elements are
	 * written to the correct namespace, you must set the {@code XMLOutputFactory.IS_REPAIRING_NAMESPACES} property on
	 * the {@code XMLOutputFactory} to "true". You may also wish to specify a prefix for the MarkLogic search namespace;
	 * you may do so via e.g. {@code xmlStreamWriter.setPrefix("search", "http://marklogic.com/appservices/search");}.
	 *
	 * @param xmlStreamWriter The XML stream writer to which the query definition should be serialized.
	 * @throws XMLStreamException
	 * @since 6.2.0
	 */
	void serialize(XMLStreamWriter xmlStreamWriter) throws XMLStreamException;

  /**
   * Returns the query criteria, that is the query string.
   * @return The query string.
   */
  String getCriteria();

  /**
   * Sets the query criteria as a query string.
   * @param criteria The query string.
   */
  void setCriteria(String criteria);

  /**
   * Sets the query criteria as a query string and returns the query
   * definition as a fluent convenience.
   * @param criteria The query string.
   * @return	This query definition.
   */
  StructuredQueryDefinition withCriteria(String criteria);
}