Top Description Fields Constructors Methods
org.apache.catalina.valves

public Class HealthCheckValve

extends ValveBase
Class Inheritance
Imports
java.io.IOException, jakarta.servlet.ServletException, jakarta.servlet.http.HttpServletResponse, org.apache.catalina.Container, .Context, .LifecycleException, org.apache.catalina.connector.Request, .Response, org.apache.catalina.util.LifecycleBase, org.apache.tomcat.util.buf.MessageBytes

Simple Valve that responds to cloud orchestrators health checks.

Field Summary

Modifier and TypeField and Description
protected boolean
checkContainersAvailable

Check if all child containers are available.

protected boolean
context

Will be set to true if the valve is associated with a context.

private static final String
private String
private static final String
Inherited from org.apache.catalina.valves.ValveBase:
asyncSupportedcontainercontainerLognextsm

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public boolean
public final String
public void
invoke(Request
The servlet request to be processed
request
,
Response
The servlet response to be created
response
)

Implements org.apache.catalina.Valve.invoke.

Perform request processing as required by this Valve.

protected boolean
public void
setCheckContainersAvailable(boolean checkContainersAvailable)

public final void
protected void
Inherited from org.apache.catalina.valves.ValveBase:
backgroundProcessgetContainergetDomainInternalgetNextgetObjectNameKeyPropertiesinitInternalisAsyncSupportedsetAsyncSupportedsetContainersetNextstopInternaltoString

Field Detail

checkContainersAvailableback to summary
protected boolean checkContainersAvailable

Check if all child containers are available.

contextback to summary
protected boolean context

Will be set to true if the valve is associated with a context.

DOWNback to summary
private static final String DOWN
pathback to summary
private String path
UPback to summary
private static final String UP

Constructor Detail

HealthCheckValveback to summary
public HealthCheckValve()

Method Detail

getCheckContainersAvailableback to summary
public boolean getCheckContainersAvailable()
getPathback to summary
public final String getPath()
invokeback to summary
public void invoke(Request request, Response response) throws IOException, ServletException

Implements org.apache.catalina.Valve.invoke.

Doc from org.apache.catalina.Valve.invoke.

Perform request processing as required by this Valve.

An individual Valve MAY perform the following actions, in the specified order:

  • Examine and/or modify the properties of the specified Request and Response.
  • Examine the properties of the specified Request, completely generate the corresponding Response, and return control to the caller.
  • Examine the properties of the specified Request and Response, wrap either or both of these objects to supplement their functionality, and pass them on.
  • If the corresponding Response was not generated (and control was not returned, call the next Valve in the pipeline (if there is one) by executing getNext().invoke().
  • Examine, but not modify, the properties of the resulting Response (which was created by a subsequently invoked Valve or Container).

A Valve MUST NOT do any of the following things:

  • Change request properties that have already been used to direct the flow of processing control for this request (for instance, trying to change the virtual host to which a Request should be sent from a pipeline attached to a Host or Context in the standard implementation).
  • Create a completed Response AND pass this Request and Response on to the next Valve in the pipeline.
  • Consume bytes from the input stream associated with the Request, unless it is completely generating the response, or wrapping the request before passing it on.
  • Modify the HTTP headers included with the Response after the getNext().invoke() method has returned.
  • Perform any actions on the output stream associated with the specified Response after the getNext().invoke() method has returned.
Parameters
request:Request

The servlet request to be processed

response:Response

The servlet response to be created

Annotations
@Override
Exceptions
IOException:
if an input/output error occurs, or is thrown by a subsequently invoked Valve, Filter, or Servlet
ServletException:
if a servlet error occurs, or is thrown by a subsequently invoked Valve, Filter, or Servlet
isAvailableback to summary
protected boolean isAvailable(Container container)
setCheckContainersAvailableback to summary
public void setCheckContainersAvailable(boolean checkContainersAvailable)
setPathback to summary
public final void setPath(String path)
startInternalback to summary
protected void startInternal() throws LifecycleException

Overrides org.apache.catalina.valves.ValveBase.startInternal.

Doc from org.apache.catalina.valves.ValveBase.startInternal.

Start this component and implement the requirements of org.apache.catalina.util.LifecycleBase#startInternal().

Annotations
@Override
Exceptions
LifecycleException:
if this component detects a fatal error that prevents this component from being used