Skip to content

Commit

Permalink
WW-3714 Deprecate and migrate ActionProxy
Browse files Browse the repository at this point in the history
  • Loading branch information
kusalk committed Oct 17, 2024
1 parent 69bd309 commit e7e0178
Show file tree
Hide file tree
Showing 4 changed files with 180 additions and 85 deletions.
12 changes: 11 additions & 1 deletion core/src/main/java/com/opensymphony/xwork2/ActionInvocation.java
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,9 @@ public interface ActionInvocation extends org.apache.struts2.ActionInvocation {
@Override
Result getResult() throws Exception;

@Override
ActionProxy getProxy();

@Override
default void addPreResultListener(org.apache.struts2.interceptor.PreResultListener listener) {
addPreResultListener(PreResultListener.adapt(listener));
Expand All @@ -49,6 +52,13 @@ default void setActionEventListener(org.apache.struts2.ActionEventListener liste

void setActionEventListener(ActionEventListener listener);

@Override
default void init(org.apache.struts2.ActionProxy proxy) {
init(ActionProxy.adapt(proxy));
}

void init(ActionProxy proxy);

static ActionInvocation adapt(org.apache.struts2.ActionInvocation actualInvocation) {
return actualInvocation != null ? new LegacyAdapter(actualInvocation) : null;
}
Expand Down Expand Up @@ -78,7 +88,7 @@ public ActionContext getInvocationContext() {

@Override
public ActionProxy getProxy() {
return adaptee.getProxy();
return ActionProxy.adapt(adaptee.getProxy());
}

@Override
Expand Down
148 changes: 66 additions & 82 deletions core/src/main/java/com/opensymphony/xwork2/ActionProxy.java
Original file line number Diff line number Diff line change
Expand Up @@ -20,88 +20,72 @@

import com.opensymphony.xwork2.config.entities.ActionConfig;

/**
* ActionProxy is an extra layer between XWork and the action so that different proxies are possible.
*
* <p>
* An example of this would be a remote proxy, where the layer between XWork and the action might be RMI or SOAP.
* </p>
*
* @author Jason Carreira
*/
public interface ActionProxy {

/**
* Gets the Action instance for this Proxy.
*
* @return the Action instance
*/
Object getAction();

/**
* Gets the alias name this ActionProxy is mapped to.
*
* @return the alias name
*/
String getActionName();

/**
* Gets the ActionConfig this ActionProxy is built from.
*
* @return the ActionConfig
*/
ActionConfig getConfig();

/**
* Sets whether this ActionProxy should also execute the Result after executing the Action.
*
* @param executeResult <tt>true</tt> to also execute the Result.
*/
void setExecuteResult(boolean executeResult);

/**
* Gets the status of whether the ActionProxy is set to execute the Result after the Action is executed.
*
* @return the status
*/
boolean getExecuteResult();

/**
* Gets the ActionInvocation associated with this ActionProxy.
*
* @return the ActionInvocation
*/
@Deprecated
public interface ActionProxy extends org.apache.struts2.ActionProxy {

@Override
ActionInvocation getInvocation();

/**
* Gets the namespace the ActionConfig for this ActionProxy is mapped to.
*
* @return the namespace
*/
String getNamespace();

/**
* Execute this ActionProxy. This will set the ActionContext from the ActionInvocation into the ActionContext
* ThreadLocal before invoking the ActionInvocation, then set the old ActionContext back into the ThreadLocal.
*
* @return the result code returned from executing the ActionInvocation
* @throws Exception can be thrown.
* @see ActionInvocation
*/
String execute() throws Exception;

/**
* Gets the method name to execute, or <tt>null</tt> if no method has been specified (meaning <code>execute</code> will be invoked).
*
* @return the method to execute
*/
String getMethod();

/**
* Gets status of the method value's initialization.
*
* @return true if the method returned by getMethod() is not a default initializer value.
*/
boolean isMethodSpecified();

static ActionProxy adapt(org.apache.struts2.ActionProxy actualProxy) {
return actualProxy != null ? new LegacyAdapter(actualProxy) : null;
}

class LegacyAdapter implements ActionProxy {

private final org.apache.struts2.ActionProxy adaptee;

private LegacyAdapter(org.apache.struts2.ActionProxy adaptee) {
this.adaptee = adaptee;
}

@Override
public Object getAction() {
return adaptee.getAction();
}

@Override
public String getActionName() {
return adaptee.getActionName();
}

@Override
public ActionConfig getConfig() {
return adaptee.getConfig();
}

@Override
public void setExecuteResult(boolean executeResult) {
adaptee.setExecuteResult(executeResult);
}

@Override
public boolean getExecuteResult() {
return adaptee.getExecuteResult();
}

@Override
public ActionInvocation getInvocation() {
return ActionInvocation.adapt(adaptee.getInvocation());
}

@Override
public String getNamespace() {
return adaptee.getNamespace();
}

@Override
public String execute() throws Exception {
return adaptee.execute();
}

@Override
public String getMethod() {
return adaptee.getMethod();
}

@Override
public boolean isMethodSpecified() {
return adaptee.isMethodSpecified();
}
}
}
3 changes: 1 addition & 2 deletions core/src/main/java/org/apache/struts2/ActionInvocation.java
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,6 @@
package org.apache.struts2;

import com.opensymphony.xwork2.ActionChainResult;
import com.opensymphony.xwork2.ActionProxy;
import com.opensymphony.xwork2.util.ValueStack;
import org.apache.struts2.interceptor.PreResultListener;

Expand Down Expand Up @@ -176,6 +175,6 @@ public interface ActionInvocation {
*/
void setActionEventListener(ActionEventListener listener);

void init(ActionProxy proxy) ;
void init(ActionProxy proxy);

}
102 changes: 102 additions & 0 deletions core/src/main/java/org/apache/struts2/ActionProxy.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.struts2;

import com.opensymphony.xwork2.config.entities.ActionConfig;

/**
* ActionProxy is an extra layer between XWork and the action so that different proxies are possible.
*
* <p>
* An example of this would be a remote proxy, where the layer between XWork and the action might be RMI or SOAP.
* </p>
*
* @author Jason Carreira
*/
public interface ActionProxy {

/**
* Gets the Action instance for this Proxy.
*
* @return the Action instance
*/
Object getAction();

/**
* Gets the alias name this ActionProxy is mapped to.
*
* @return the alias name
*/
String getActionName();

/**
* Gets the ActionConfig this ActionProxy is built from.
*
* @return the ActionConfig
*/
ActionConfig getConfig();

/**
* Sets whether this ActionProxy should also execute the Result after executing the Action.
*
* @param executeResult <tt>true</tt> to also execute the Result.
*/
void setExecuteResult(boolean executeResult);

/**
* Gets the status of whether the ActionProxy is set to execute the Result after the Action is executed.
*
* @return the status
*/
boolean getExecuteResult();

ActionInvocation getInvocation();

/**
* Gets the namespace the ActionConfig for this ActionProxy is mapped to.
*
* @return the namespace
*/
String getNamespace();

/**
* Execute this ActionProxy. This will set the ActionContext from the ActionInvocation into the ActionContext
* ThreadLocal before invoking the ActionInvocation, then set the old ActionContext back into the ThreadLocal.
*
* @return the result code returned from executing the ActionInvocation
* @throws Exception can be thrown.
* @see ActionInvocation
*/
String execute() throws Exception;

/**
* Gets the method name to execute, or <tt>null</tt> if no method has been specified (meaning <code>execute</code> will be invoked).
*
* @return the method to execute
*/
String getMethod();

/**
* Gets status of the method value's initialization.
*
* @return true if the method returned by getMethod() is not a default initializer value.
*/
boolean isMethodSpecified();

}

0 comments on commit e7e0178

Please sign in to comment.