org.apache.wicket.devutils.debugbar
Class DebugBar

java.lang.Object
  extended by org.apache.wicket.Component
      extended by org.apache.wicket.MarkupContainer
          extended by org.apache.wicket.markup.html.WebMarkupContainer
              extended by org.apache.wicket.markup.html.panel.Panel
                  extended by org.apache.wicket.devutils.DevUtilsPanel
                      extended by org.apache.wicket.devutils.debugbar.DebugBar
All Implemented Interfaces:
Serializable, Iterable<Component>, IEventSink, IEventSource, IConverterLocator, IHeaderContributor, IRequestableComponent, org.apache.wicket.util.IHierarchical<Component>, org.apache.wicket.util.io.IClusterable

public class DebugBar
extends DevUtilsPanel

The debug bar is for use during development. It allows contributors to add useful functions or data, making them readily accessible to the developer.

To use it, simply add it to your base page so that all of your pages automatically have it.

Java: add(new DebugBar("debug")); HTML: <div wicket:id="debug"></div>
You can also add your own information to the bar by creating a IDebugBarContributor and registering it with the debug bar.

The debug bar uses CSS absolute positioning to appear in the top-right corner of the page. Important: if there is an element with a z-index in this part of your page, the DebugBar will need a higher "z-index" style value to show up. Or you can use different position for it. See wicket-debugbar.css.

Author:
Jeremy Thomerson
See Also:
IDebugBarContributor, Serialized Form

Field Summary
 
Fields inherited from class org.apache.wicket.markup.html.panel.Panel
PANEL
 
Fields inherited from class org.apache.wicket.Component
ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER
 
Constructor Summary
DebugBar(String id)
          Construct.
DebugBar(String id, boolean initiallyExpanded)
          Construct.
 
Method Summary
static List<IDebugBarContributor> getContributors(Application application)
           
 boolean isVisible()
           
static void registerContributor(IDebugBarContributor contrib)
          Register your own custom contributor that will be part of the debug bar.
static void registerContributor(IDebugBarContributor contrib, Application application)
          Register your own custom contributor that will be part of the debug bar.
 void renderHead(IHeaderResponse response)
           
static void setContributors(List<IDebugBarContributor> contributors, Application application)
           
 
Methods inherited from class org.apache.wicket.devutils.DevUtilsPanel
onBeforeRender
 
Methods inherited from class org.apache.wicket.markup.html.panel.Panel
newMarkupSourcingStrategy
 
Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer
getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession
 
Methods inherited from class org.apache.wicket.MarkupContainer
add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onComponentTagBody, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren
 
Methods inherited from class org.apache.wicket.Component
add, addStateChange, afterRender, beforeRender, canCallListenerInterface, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onComponentTag, onConfigure, onDetach, onEvent, onInitialize, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DebugBar

public DebugBar(String id)
Construct.

Create debug bar (initially expanded)

Parameters:
id - component id
See Also:
DebugBar(String, boolean)

DebugBar

public DebugBar(String id,
                boolean initiallyExpanded)
Construct.

Parameters:
id - component id
initiallyExpanded - true to show debug bar initially expanded
See Also:
DebugBar(String)
Method Detail

isVisible

public boolean isVisible()
Overrides:
isVisible in class Component

renderHead

public void renderHead(IHeaderResponse response)
Specified by:
renderHead in interface IHeaderContributor
Overrides:
renderHead in class Component

registerContributor

public static void registerContributor(IDebugBarContributor contrib)
Register your own custom contributor that will be part of the debug bar. You must have the context of an application for this thread at the time of calling this method.

Parameters:
contrib - custom contributor - can not be null

registerContributor

public static void registerContributor(IDebugBarContributor contrib,
                                       Application application)
Register your own custom contributor that will be part of the debug bar. You must have the context of an application for this thread at the time of calling this method.

Parameters:
application -
contrib - custom contributor - can not be null

getContributors

public static List<IDebugBarContributor> getContributors(Application application)

setContributors

public static void setContributors(List<IDebugBarContributor> contributors,
                                   Application application)


Copyright © 2006–2020 Apache Software Foundation. All rights reserved.