* {@link com.vaadin.client.ApplicationConnection}.
* <p>
* TODO Document better!
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+@Deprecated
@SuppressWarnings("serial")
public abstract class AbstractCommunicationManager implements Serializable {
* TODO Document me!
*
* @author peholmst
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public interface Callback extends Serializable {
public void criticalNotification(WrappedRequest request,
return bootstrapHandler;
}
+ /**
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected abstract BootstrapHandler createBootstrapHandler();
/**
import com.vaadin.shared.Version;
import com.vaadin.ui.UI;
+/**
+ *
+ * @author Vaadin Ltd
+ * @since 7.0.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+@Deprecated
public abstract class BootstrapHandler implements RequestHandler {
protected class BootstrapContext implements Serializable {
}
@Override
- public boolean handleRequest(VaadinSession session,
- WrappedRequest request, WrappedResponse response)
- throws IOException {
+ public boolean handleRequest(VaadinSession session, WrappedRequest request,
+ WrappedResponse response) throws IOException {
try {
Class<? extends UI> uiClass = session.getUIClass(request);
*
* @author Vaadin Ltd.
* @since 5.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+@Deprecated
@SuppressWarnings("serial")
public class CommunicationManager extends AbstractCommunicationManager {
*
* @author peholmst
*
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+@Deprecated
@SuppressWarnings("serial")
public class PortletCommunicationManager extends AbstractCommunicationManager {
*/
public class VaadinPortlet extends GenericPortlet implements Constants {
+ /**
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
public static final String RESOURCE_URL_ID = "APP";
public static class PortletService extends AbstractVaadinService {
/**
* This portlet parameter is used to add styles to the main element. E.g
* "height:500px" generates a style="height:500px" to the main element.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public static final String PORTLET_PARAMETER_STYLE = "style";
/**
* This portal parameter is used to define the name of the Vaadin theme that
* is used for all Vaadin applications in the portal.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public static final String PORTAL_PARAMETER_VAADIN_THEME = "vaadin.theme";
+ /**
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
public static final String WRITE_AJAX_PAGE_SCRIPT_WIDGETSET_SHOULD_WRITE = "writeAjaxPageScriptWidgetsetShouldWrite";
// TODO some parts could be shared with AbstractApplicationServlet
addonContext.destroy();
}
+ /**
+ * @author Vaadin Ltd
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected enum RequestType {
FILE_UPLOAD, UIDL, RENDER, STATIC_FILE, APPLICATION_RESOURCE, DUMMY, EVENT, ACTION, UNKNOWN, BROWSER_DETAILS, CONNECTOR_RESOURCE, HEARTBEAT;
}
+ /**
+ * @param wrappedRequest
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected RequestType getRequestType(WrappedPortletRequest wrappedRequest) {
PortletRequest request = wrappedRequest.getPortletRequest();
if (request instanceof RenderRequest) {
&& request.getResourceID().equals("DUMMY");
}
+ /**
+ * @param request
+ * @param response
+ * @throws PortletException
+ * @throws IOException
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected void handleRequest(PortletRequest request,
PortletResponse response) throws PortletException, IOException {
RequestTimer requestTimer = new RequestTimer();
handleRequest(request, response);
}
+ /**
+ * @param request
+ * @param requestType
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
boolean requestCanCreateApplication(PortletRequest request,
RequestType requestType) {
if (requestType == RequestType.UIDL && isRepaintAll(request)) {
* url to load after message, null for current page
* @throws IOException
* if the writing failed due to input/output error.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
void criticalNotification(WrappedPortletRequest request,
WrappedPortletResponse response, String caption, String message,
String details, String url) throws IOException {
* {@link PortletSession#setAttribute()} is called with the context as value.
*
* @author peholmst
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+@Deprecated
@SuppressWarnings("serial")
public class VaadinPortletSession extends VaadinSession {
* the current page.
* @throws IOException
* if the writing failed due to input/output error.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected void criticalNotification(WrappedHttpServletRequest request,
HttpServletResponse response, String caption, String message,
String details, String url) throws IOException {
* @param request
* @param requestType
* @return true if an application should be created, false otherwise
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
boolean requestCanCreateApplication(HttpServletRequest request,
RequestType requestType) {
if (requestType == RequestType.UIDL && isRepaintAll(request)) {
* @param path
* the resource path.
* @return the resource path.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected static String getResourcePath(ServletContext servletContext,
String path) {
String resultPath = null;
*
* @param themeName
* @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected static String stripSpecialChars(String themeName) {
StringBuilder sb = new StringBuilder();
char[] charArray = themeName.toCharArray();
return DEFAULT_THEME_NAME;
}
+ /**
+ * @param request
+ * @param response
+ * @throws IOException
+ * @throws ServletException
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
void handleServiceSessionExpired(WrappedHttpServletRequest request,
WrappedHttpServletResponse response) throws IOException,
ServletException {
* @return
*
* @since 6.6.7
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected boolean isAllowedVAADINResourceUrl(HttpServletRequest request,
URL resourceUrl) {
if ("jar".equals(resourceUrl.getProtocol())) {
return false;
}
+ /**
+ *
+ * @author Vaadin Ltd
+ * @since 7.0.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected enum RequestType {
FILE_UPLOAD, BROWSER_DETAILS, UIDL, OTHER, STATIC_FILE, APPLICATION_RESOURCE, CONNECTOR_RESOURCE, HEARTBEAT;
}
+ /**
+ * @param request
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected RequestType getRequestType(WrappedHttpServletRequest request) {
if (ServletPortletHelper.isFileUploadRequest(request)) {
return RequestType.FILE_UPLOAD;
* @throws MalformedURLException
* if the application is denied access to the persistent data
* store represented by the given URL.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected URL getApplicationUrl(HttpServletRequest request)
throws MalformedURLException {
final URL reqURL = new URL(
* @throws IllegalAccessException
* @throws InstantiationException
* @throws SessionExpiredException
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected VaadinSession getExistingApplication(HttpServletRequest request,
boolean allowSessionCreation) throws MalformedURLException,
SessionExpiredException {
*
* @param request
* @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected String getRequestPathInfo(HttpServletRequest request) {
return request.getPathInfo();
}
* @param resource
* the Theme resource.
* @return External URI specifying the resource
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public String getResourceLocation(String theme, ThemeResource resource) {
if (resourcePath == null) {
}
}
+ /**
+ * @param session
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
protected VaadinSession getApplicationContext(final HttpSession session) {
VaadinSession sessionApplication = VaadinSession
.getForSession(new WrappedHttpSession(session));
*
* @param application
* @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public CommunicationManager createCommunicationManager(
*
* @param unsafe
* @return a safe string to be added inside an html tag
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public static final String safeEscapeForHtml(String unsafe) {
if (null == unsafe) {
return null;
*
* @author Vaadin Ltd.
* @since 3.1
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+@Deprecated
@SuppressWarnings("serial")
public class VaadinServletSession extends VaadinSession {
* data.
*
* @author Vaadin Ltd
- * @version @VERSION@
* @since 7.0.0
*/
@SuppressWarnings("serial")
* An event sent to {@link #start(SessionStartEvent)} when a new Application
* is being started.
*
- * @since 7.0
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public static class SessionStartEvent implements Serializable {
* Get the web browser associated with this session.
*
* @return
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public WebBrowser getBrowser() {
return browser;
}
return session;
}
+ /**
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
+ @Deprecated
public AbstractCommunicationManager getApplicationManager() {
return communicationManager;
}
* </p>
*
* @return the application's URL.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public URL getURL() {
* redirected to the application logout url set with
* {@link #setLogoutURL(String)}. If the logout url has not been set, the
* browser window is reloaded and the application is restarted.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public void close() {
}
}
+ /**
+ * @param underlyingSession
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
public static VaadinSession getForSession(WrappedSession underlyingSession) {
Object attribute = underlyingSession.getAttribute(VaadinSession.class
return null;
}
+ /**
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
public void removeFromSession() {
assert (getForSession(session) == this);
session.setAttribute(VaadinSession.class.getName(), null);
}
+ /**
+ * @param session
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
public void storeInSession(WrappedSession session) {
session.setAttribute(VaadinSession.class.getName(), this);
* the application start event containing details required for
* starting the application.
*
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public void start(SessionStartEvent event) {
*
* @return <code>true</code> if the application is running,
* <code>false</code> if not.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public boolean isRunning() {
*
* This event is sent each time a window is removed from the application
* with {@link com.vaadin.server.VaadinSession#removeWindow(Window)}.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public static class WindowDetachEvent extends EventObject {
private final Window window;
*
* This event is sent each time a window is attached tothe application with
* {@link com.vaadin.server.VaadinSession#addWindow(Window)}.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public static class WindowAttachEvent extends EventObject {
private final Window window;
* </p>
*
* @return the URL.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public String getLogoutURL() {
*
* @param logoutURL
* the logoutURL to set.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public void setLogoutURL(String logoutURL) {
* @see WrappedRequest#getBrowserDetails()
*
* @since 7.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public Class<? extends UI> getUIClass(WrappedRequest request) {
* @param request
* @param uiClass
* @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
protected <T extends UI> T createUIInstance(WrappedRequest request,
* provided).
*
* @since 7.0.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public UIProvider getUiProvider(WrappedRequest request, Class<?> uiClass) {
return provider;
}
+ /**
+ * @param request
+ * @param uiClass
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
private UIProvider doGetUiProvider(WrappedRequest request, Class<?> uiClass) {
int providersSize = uiProviders.size();
* @see #createUI(WrappedRequest)
*
* @since 7.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public UI getUIForRequest(WrappedRequest request) {
return uI;
}
+ /**
+ * @param request
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
private UI findExistingUi(WrappedRequest request) {
// Check if some UI provider has an existing UI available
return null;
}
+ /**
+ * @param request
+ * @return
+ *
+ * @deprecated might be refactored or removed before 7.0.0
+ */
@Deprecated
public UI createUI(WrappedRequest request) {
Class<? extends UI> uiClass = getUIClass(request);
* @return a UI id, or <code>null</code> if no UI id is defined
*
* @since 7.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
private static Integer getUIId(WrappedRequest request) {
* @param connector
* A connector that has not yet been assigned an id.
* @return A new id for the connector
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public String createConnectorId(ClientConnector connector) {
return String.valueOf(connectorIdSequence++);
}
* @param response
* the bootstrap response event for which listeners should be
* fired
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
@Deprecated
public void modifyBootstrapResponse(BootstrapResponse response) {
* @see #isUIAlive(UI)
*
* @since 7.0.0
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
public void closeInactiveUIs() {
for (Iterator<UI> i = uIs.values().iterator(); i.hasNext();) {
UI ui = i.next();
* @param ui
* The UI whose status to check
* @return true if the UI is alive, false if it could be removed.
+ *
+ * @deprecated might be refactored or removed before 7.0.0
*/
+ @Deprecated
protected boolean isUIAlive(UI ui) {
long now = System.currentTimeMillis();
if (getHeartbeatTimeout() >= 0