org.eclipse.jetty.util.component

Interface Dumpable

All Known Implementing Classes:

AbstractConnectionFactory, AbstractConnectionPool, AbstractConnector, AbstractConnectorHttpClientTransport, AbstractHandler, AbstractHandler.ErrorDispatchHandler, AbstractHandlerContainer, AbstractHttpClientTransport, AbstractLoginService, AbstractNCSARequestLog, AbstractNetworkConnector, AbstractSessionCache, AbstractSessionDataStore, AbstractWebSocketConnection, AsyncDelayHandler, AsyncNCSARequestLog, AttributeContainerMap, AttributesMap, BaseHolder, BufferedResponseHandler, CachingSessionDataStore, ClassLoaderDump, ConfigurableSpnegoLoginService, ConnectionManager, ConnectionStatistics, ConnectorStatistics, ConstraintSecurityHandler, ContainerLifeCycle, ContextHandler, ContextHandler.Context, ContextHandler.StaticContext, ContextHandlerCollection, CustomRequestLog, DebugHandler, DefaultHandler, DefaultSessionCache, DefaultSessionIdManager, DetectorConnectionFactory, DumpableCollection, DuplexConnectionPool, EatWhatYouKill, ErrorHandler, ErrorPageErrorHandler, ExecutorSizedThreadPool, ExecutorThreadPool, ExtensionStack, FileSessionDataStore, FilterHolder, FilterMapping, GzipHandler, HandlerCollection, HandlerList, HandlerWrapper, HashLoginService, Holder, HotSwapHandler, HttpClient, HttpClientTransportOverHTTP, HttpConfiguration, HttpConnectionFactory, HttpConversation, HttpDestination, HttpDestinationOverHTTP, IdleTimeoutHandler, InetAccessHandler, IPAccessHandler, JDBCLoginService, JDBCSessionDataStore, LeakTrackingByteBufferPool, LeakTrackingConnectionPool, ListenerHolder, LocalConnector, LowResourceMonitor, ManagedSelector, MBeanContainer, MonitoredQueuedThreadPool, MovedContextHandler, MultiplexConnectionPool, MultiplexHttpDestination, NativeWebSocketConfiguration, NCSARequestLog, NegotiatingServerConnectionFactory, NetworkTrafficSelectChannelConnector, NetworkTrafficServerConnector, NullSessionCache, NullSessionDataStore, OptionalSslConnectionFactory, PathMappings, PoolingHttpDestination, ProtocolHandlers, ProxyConnectionFactory, ProxyConnectionFactory.ProxyEndPoint, QueuedThreadPool, RequestLogHandler, ResourceHandler, RoundRobinConnectionPool, ScheduledExecutorScheduler, ScopedHandler, SecuredRedirectHandler, SecurityHandler, SelectorManager, Server, ServerConnectionStatistics, ServerConnector, ServletContextHandler, ServletContextHandler.Context, ServletHandler, ServletHolder, SessionHandler, SessionTracker, ShutdownHandler, SimpleContainerScope, Slf4jRequestLog, SslConnectionFactory, SslContextFactory, SslContextFactory.Client, SslContextFactory.Server, StatisticsHandler, ThreadLimitHandler, ValidatingConnectionPool, WebAppContext, WebAppContext.Context, WebSocketClient, WebSocketClientConnection, WebSocketExtensionFactory, 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 String	KEY

Method Summary

Modifier and Type	Method and Description
default String	dump()
void	dump(Appendable out, String indent) Dump this object (and children) into an Appendable using the provided indent after any new lines.
static String	dump(Dumpable dumpable) Utility method to implement dump() by calling dump(Appendable, String)
static void	dumpContainer(Appendable out, String indent, Container object, boolean last)
static void	dumpIterable(Appendable out, String indent, Iterable<?> iterable, boolean last)
static void	dumpMapEntries(Appendable out, String indent, Map<?,?> map, boolean last)
static void	dumpObject(Appendable out, Object o) Dump just an Object (but not it's contained items) to an Appendable.
static void	dumpObjects(Appendable out, String indent, Object object, Object... extraChildren) Dump an Object, it's contained items and additional items to an Appendable.
default String	dumpSelf() The description of this/self found in the dump.
static Dumpable	named(String name, Object object)

Field Detail

KEY

static final String KEY

See Also:

Constant Field Values

Method Detail

dump

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

dump

void dump(Appendable out,
          String indent)
   throws 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:

IOException - if unable to write to Appendable

dump

static 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 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(Appendable out,
                       Object o)
                throws 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:

IOException - May be thrown by the Appendable

dumpObjects

static void dumpObjects(Appendable out,
                        String indent,
                        Object object,
                        Object... extraChildren)
                 throws 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:

IOException - May be thrown by the Appendable

dumpContainer

static void dumpContainer(Appendable out,
                          String indent,
                          Container object,
                          boolean last)
                   throws IOException

Throws:

IOException

dumpIterable

static void dumpIterable(Appendable out,
                         String indent,
                         Iterable<?> iterable,
                         boolean last)
                  throws IOException

Throws:

IOException

dumpMapEntries

static void dumpMapEntries(Appendable out,
                           String indent,
                           Map<?,?> map,
                           boolean last)
                    throws IOException

Throws:

IOException

named

static Dumpable named(String name,
                      Object object)