org.eclipse.jetty.util.component

Interface Dumpable

All Known Implementing Classes:

AbstractConnectionFactory, AbstractConnectionPool, AbstractConnector, AbstractConnectorHttpClientTransport, AbstractConnectorHttpClientTransport.ClientSelectorManager, AbstractFlowControlStrategy, AbstractHandler, AbstractHandler.ErrorDispatchHandler, AbstractHandlerContainer, AbstractHTTP2ServerConnectionFactory, AbstractHTTP2ServerConnectionFactory.HTTP2SessionContainer, AbstractHttpClientTransport, AbstractNCSARequestLog, AbstractNetworkConnector, AbstractSessionCache, AbstractSessionDataStore, AbstractWebSocketConnection, ALPNServerConnectionFactory, AntWebAppContext, AntWebAppContext.AntServletHandler, AntWebAppContext.AntServletHolder, AsyncDelayHandler, AsyncNCSARequestLog, AttributesMap, BaseHolder, BufferedResponseHandler, BufferingFlowControlStrategy, CachingSessionDataStore, ClassLoaderDump, ClientContainer, ConfigurableSpnegoLoginService, ConnectHandler, ConnectHandler.ConnectManager, ConnectionManager, ConnectionStatistics, ConnectorStatistics, ConstraintSecurityHandler, ContainerLifeCycle, ContextHandler, ContextHandler.Context, ContextHandler.StaticContext, ContextHandlerCollection, CustomRequestLog, DebugHandler, DefaultHandler, DefaultSessionCache, DefaultSessionIdManager, DelegatingThreadPool, DeploymentManager, DumpableCollection, DuplexConnectionPool, EatWhatYouKill, EmbeddedCdiHandler, ErrorHandler, ErrorPageErrorHandler, ExecutorSizedThreadPool, ExecutorThreadPool, ExtensionStack, FileSessionDataStore, FilterHolder, FilterMapping, GzipHandler, HandlerCollection, HandlerList, HandlerWrapper, HelloHandler, HelloWorld, Holder, HotSwapHandler, HTTP2Client, HTTP2ClientSession, HTTP2CServerConnectionFactory, HTTP2Flusher, HTTP2ServerConnectionFactory, HTTP2ServerSession, HTTP2Session, HTTP2Stream, HttpClient, HttpClientTransportOverFCGI, HttpClientTransportOverHTTP, HttpClientTransportOverHTTP2, HttpClientTransportOverUnixSockets, HttpClientTransportOverUnixSockets.UnixSocketSelectorManager, HttpConfiguration, HttpConnectionFactory, HttpConversation, HttpDestination, HttpDestinationOverFCGI, HttpDestinationOverHTTP, HttpDestinationOverHTTP2, HttpServiceErrorPageErrorHandler, HttpSpiContextHandler, IdleTimeoutHandler, InetAccessHandler, InfinispanSessionDataStore, IPAccessHandler, JDBCSessionDataStore, JettyWebAppContext, JsrSession, LeakTrackingByteBufferPool, LeakTrackingConnectionPool, ListenerHolder, LocalConnector, LowResourceMonitor, ManagedSelector, ManyHandlers.ParamHandler, ManyHandlers.WelcomeWrapHandler, MavenServerConnector, MBeanContainer, MongoSessionDataStore, MonitoredQueuedThreadPool, MovedContextHandler, MultiplexConnectionPool, MultiplexHttpDestination, MultiplexHttpDestinationOverFCGI, NamingContext, NativeWebSocketConfiguration, NCSARequestLog, NegotiatingServerConnectionFactory, NetworkTrafficSelectChannelConnector, NetworkTrafficServerConnector, NoSqlSessionDataStore, NullSessionCache, NullSessionDataStore, OptionalSslConnectionFactory, PathMappings, PoolingHttpDestination, ProtocolHandlers, ProxyConnectionFactory, ProxyConnectionFactory.ProxyEndPoint, QueuedThreadPool, QuickStartWebApp, RawHTTP2ServerConnectionFactory, RequestLogHandler, ResourceHandler, RewriteHandler, RoundRobinConnectionPool, ScheduledExecutorScheduler, ScopedHandler, SecuredRedirectHandler, SecurityHandler, SelectorManager, Server, ServerConnectionStatistics, ServerConnector, ServerConnector.ServerConnectorManager, ServerContainer, ServerFCGIConnectionFactory, ServletContextHandler, ServletContextHandler.Context, ServletHandler, ServletHolder, SessionHandler, ShutdownHandler, SimpleContainerScope, SimpleFlowControlStrategy, Slf4jRequestLog, SslConnectionFactory, SslContextFactory, StatisticsHandler, TestSessionDataStore, TestSessionHandler, ThreadLimitHandler, UnixSocketConnector, UnixSocketConnector.UnixSocketConnectorManager, ValidatingConnectionPool, WebAppContext, WebAppContext.Context, WebSocketClient, WebSocketClientConnection, WebSocketHandler, WebSocketHandler.Simple, WebSocketServerConnection, WebSocketServerFactory, WebSocketSession, WebSocketUpgradeFilter, WebSocketUpgradeHandlerWrapper

@ManagedObject(value="Dumpable Object")
public interface Dumpable

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	KEY

Method Summary

Modifier and Type	Method and Description
default java.lang.String	dump()
void	dump(java.lang.Appendable out, java.lang.String indent) Dump this object (and children) into an Appendable using the provided indent after any new lines.
static java.lang.String	dump(Dumpable dumpable) Utility method to implement dump() by calling dump(Appendable, String)
static void	dumpObject(java.lang.Appendable out, java.lang.Object o) Dump just an Object (but not it's contained items) to an Appendable.
static void	dumpObjects(java.lang.Appendable out, java.lang.String indent, java.lang.Object object, java.lang.Object... extraChildren) Dump an Object, it's contained items and additional items to an Appendable.
default java.lang.String	dumpSelf() The description of this/self found in the dump.

Field Detail

KEY

static final java.lang.String KEY

See Also:

Constant Field Values

Method Detail

dump

@ManagedOperation(value="Dump the nested Object state as a String",
                  impact="INFO")
default java.lang.String dump()

dump

void dump(java.lang.Appendable out,
          java.lang.String indent)
   throws java.io.IOException

Dump this object (and children) into an Appendable using the provided indent after any new lines. The indent should not be applied to the first object dumped.

Parameters:

out - The appendable to dump to

indent - The indent to apply after any new lines.

Throws:

java.io.IOException - if unable to write to Appendable

dump

static java.lang.String dump(Dumpable dumpable)

Utility method to implement dump() by calling dump(Appendable, String)

Parameters:

dumpable - The dumpable to dump

Returns:

The dumped string

dumpSelf

default java.lang.String dumpSelf()

The description of this/self found in the dump. Allows for alternative representation of Object other then .toString() where the long form output of toString() is represented in a cleaner way within the dump infrastructure.

Returns:

the representation of self

dumpObject

static void dumpObject(java.lang.Appendable out,
                       java.lang.Object o)
                throws java.io.IOException

Dump just an Object (but not it's contained items) to an Appendable.

Parameters:

out - The Appendable to dump to

o - The object to dump.

Throws:

java.io.IOException - May be thrown by the Appendable

dumpObjects

static void dumpObjects(java.lang.Appendable out,
                        java.lang.String indent,
                        java.lang.Object object,
                        java.lang.Object... extraChildren)
                 throws java.io.IOException

Dump an Object, it's contained items and additional items to an Appendable. If the object in an Iterable or an Array, then its contained items are also dumped.

Parameters:

out - the Appendable to dump to

indent - The indent to apply after any new lines

object - The object to dump. If the object is an instance of Container, Stream, Iterable, Array or Map, then children of the object a recursively dumped.

extraChildren - Items to be dumped as children of the object, in addition to any discovered children of object

Throws:

java.io.IOException - May be thrown by the Appendable