Skip to content

Commit c002db4

Browse files
hisanhunaishisanhunais
authored
Merge pull request wso2#12857 from dakshina99/gateway-federation
[Gateway Federation][Feature][4.5.0] APIM Core Implementation for Gateway Federation
2 parents 677c9ec + 95992cc commit c002db4

File tree

55 files changed

+2269
-135
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+2269
-135
lines changed

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/ExceptionCodes.java

+2
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,8 @@ public enum ExceptionCodes implements ErrorHandler {
171171
400, "Gateway Environment VHOST name not provided"),
172172
INVALID_VHOST(900512, "Invalid virtual host name provided",
173173
400, "Virtual host with provided vhost name does not exist"),
174+
FEDERATED_GATEWAY_VALIDATION_FAILED(900513, "API Validation Failed with Federated Gateway",
175+
400, "API Validation Failed with %s Gateway. %s", false),
174176

175177
// Workflow related codes
176178
WORKFLOW_EXCEPTION(900550, "Workflow error", 500,

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/Environment.java

+25
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,31 @@ public class Environment implements Serializable {
5959
private String[] visibilityRoles;
6060
private String visibility;
6161

62+
public Environment() {
63+
}
64+
65+
public Environment(Environment environment) {
66+
this.type = environment.type;
67+
this.serverURL = environment.serverURL;
68+
this.userName = environment.userName;
69+
this.password = environment.password;
70+
this.apiGatewayEndpoint = environment.apiGatewayEndpoint;
71+
this.websocketGatewayEndpoint = environment.websocketGatewayEndpoint;
72+
this.webSubGatewayEndpoint = environment.webSubGatewayEndpoint;
73+
this.isDefault = environment.isDefault;
74+
this.id = environment.id;
75+
this.uuid = environment.uuid;
76+
this.name = environment.name;
77+
this.displayName = environment.displayName;
78+
this.description = environment.description;
79+
this.isReadOnly = environment.isReadOnly;
80+
this.vhosts = new ArrayList<>(environment.vhosts);
81+
this.provider = environment.provider;
82+
this.gatewayType = environment.gatewayType;
83+
this.additionalProperties = new HashMap<>(environment.additionalProperties);
84+
this.visibilityRoles = environment.visibilityRoles;
85+
this.visibility = environment.visibility;
86+
}
6287
private GatewayVisibilityPermissionConfigurationDTO permissions = new GatewayVisibilityPermissionConfigurationDTO();
6388

6489
public boolean isDefault() {

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/GatewayAPIValidationResult.java

+42
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
/*
2+
* Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
3+
*
4+
* WSO2 LLC. licenses this file to you under the Apache License,
5+
* Version 2.0 (the "License"); you may not use this file except
6+
* in compliance with the License.
7+
* You may obtain a copy of the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing,
12+
* software distributed under the License is distributed on an
13+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
* KIND, either express or implied. See the License for the
15+
* specific language governing permissions and limitations
16+
* under the License.
17+
*/
18+
19+
package org.wso2.carbon.apimgt.api.model;
20+
21+
import java.util.List;
22+
23+
public class GatewayAPIValidationResult {
24+
boolean isValid;
25+
List<String> errors;
26+
27+
public boolean isValid() {
28+
return isValid;
29+
}
30+
31+
public void setValid(boolean valid) {
32+
isValid = valid;
33+
}
34+
35+
public List<String> getErrors() {
36+
return errors;
37+
}
38+
39+
public void setErrors(List<String> errors) {
40+
this.errors = errors;
41+
}
42+
}

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/GatewayAgentConfiguration.java

+62
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
/*
2+
* Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
3+
*
4+
* WSO2 LLC. licenses this file to you under the Apache License,
5+
* Version 2.0 (the "License"); you may not use this file except
6+
* in compliance with the License.
7+
* You may obtain a copy of the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing,
12+
* software distributed under the License is distributed on an
13+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
* KIND, either express or implied. See the License for the
15+
* specific language governing permissions and limitations
16+
* under the License.
17+
*/
18+
19+
package org.wso2.carbon.apimgt.api.model;
20+
21+
import java.util.List;
22+
23+
/**
24+
* This Interface providing functionality to register Gateway Agent Related Configurations
25+
*/
26+
public interface GatewayAgentConfiguration {
27+
28+
/**
29+
* This method returns the Gateway Deployer implementation class name
30+
*
31+
* @return gateway deployer implementation class name
32+
*/
33+
String getImplementation();
34+
35+
/**
36+
* Get vendor type of the external gateway
37+
*
38+
* @return String vendor name
39+
*/
40+
String getType();
41+
42+
/**
43+
* This method returns the Configurations related to external gateway
44+
*
45+
* @return List<ConfigurationDto> connectionConfigurations
46+
*/
47+
List<ConfigurationDto> getConnectionConfigurations();
48+
49+
/**
50+
* This method returns the Gateway Feature Catalog
51+
*
52+
* @return String Gateway Feature Catalog
53+
*/
54+
GatewayFeatureCatalog getGatewayFeatureCatalog();
55+
56+
/**
57+
* This method returns the default hostname template of the external gateway
58+
*
59+
* @return String default hostname template
60+
*/
61+
public String getDefaultHostnameTemplate();
62+
}

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/GatewayConfiguration.java

+83
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
/*
2+
* Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
3+
*
4+
* WSO2 LLC. licenses this file to you under the Apache License,
5+
* Version 2.0 (the "License"); you may not use this file except
6+
* in compliance with the License.
7+
* You may obtain a copy of the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing,
12+
* software distributed under the License is distributed on an
13+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
* KIND, either express or implied. See the License for the
15+
* specific language governing permissions and limitations
16+
* under the License.
17+
*/
18+
19+
package org.wso2.carbon.apimgt.api.model;
20+
21+
import java.util.HashMap;
22+
import java.util.Map;
23+
24+
/**
25+
* Stores configurations specific for a gateway implementation.
26+
*/
27+
public class GatewayConfiguration {
28+
private String name;
29+
private String type;
30+
private String tenantDomain;
31+
private Map<String, Object> configuration = new HashMap<>();
32+
33+
public void addParameter(String name, Object value) {
34+
35+
configuration.put(name, value);
36+
}
37+
38+
public Object getParameter(String name) {
39+
40+
return configuration.get(name);
41+
}
42+
43+
public void setConfiguration(Map<String, Object> configuration) {
44+
45+
this.configuration = configuration;
46+
}
47+
48+
public Map<String, Object> getConfiguration() {
49+
50+
return configuration;
51+
}
52+
53+
public String getName() {
54+
55+
return name;
56+
}
57+
58+
public void setName(String name) {
59+
60+
this.name = name;
61+
}
62+
63+
public String getType() {
64+
65+
return type;
66+
}
67+
68+
public void setType(String type) {
69+
70+
this.type = type;
71+
}
72+
73+
public String getTenantDomain() {
74+
75+
return tenantDomain;
76+
}
77+
78+
public void setTenantDomain(String tenantDomain) {
79+
80+
this.tenantDomain = tenantDomain;
81+
}
82+
83+
}

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/GatewayDeployer.java

+80
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
/*
2+
* Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
3+
*
4+
* WSO2 LLC. licenses this file to you under the Apache License,
5+
* Version 2.0 (the "License"); you may not use this file except
6+
* in compliance with the License.
7+
* You may obtain a copy of the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing,
12+
* software distributed under the License is distributed on an
13+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
* KIND, either express or implied. See the License for the
15+
* specific language governing permissions and limitations
16+
* under the License.
17+
*/
18+
19+
package org.wso2.carbon.apimgt.api.model;
20+
21+
import org.wso2.carbon.apimgt.api.APIManagementException;
22+
23+
24+
/**
25+
* This Interface is providing functionality of external gateway specific core operations.
26+
* You can implement deploy/undeploy API methods by implementing this interface.
27+
*/
28+
public interface GatewayDeployer {
29+
30+
/**
31+
* Initialize the external gateway deployer
32+
*
33+
* @throws APIManagementException if error occurs when initializing the external gateway deployer
34+
*/
35+
void init(GatewayConfiguration configuration) throws APIManagementException;
36+
37+
/**
38+
* This method returns the type of Gateway
39+
* @return gateway type
40+
*/
41+
String getType();
42+
43+
/**
44+
* Deploy API artifact to provided environment in the external gateway
45+
*
46+
* @param api API to be deployed into in the external gateway
47+
* @param externalReference reference artifact
48+
* @throws APIManagementException if error occurs when deploying APIs to in the external gateway
49+
*/
50+
String deploy(API api, String externalReference) throws APIManagementException;
51+
52+
/**
53+
* Undeploy API artifact from provided environment
54+
*
55+
* @param externalReference reference artifact
56+
* @throws APIManagementException if error occurs when un-deploying APIs from external gateway
57+
*/
58+
boolean undeploy(String externalReference) throws APIManagementException;
59+
60+
/**
61+
* This method returns the validation result of a given API with the external gateway
62+
*
63+
* @return List<String> validation result
64+
*/
65+
GatewayAPIValidationResult validateApi(API api) throws APIManagementException;
66+
67+
/**
68+
* This method returns the resolved API execution URL by replacing all placeholders appropriately
69+
*
70+
* @return String api execution url
71+
*/
72+
String getAPIExecutionURL(String externalReference) throws APIManagementException;
73+
74+
/**
75+
* This method returns refined API by manipulating the API object according to the external gateway requirements
76+
*
77+
* @return API api object
78+
*/
79+
void transformAPI(API api) throws APIManagementException;
80+
}

‎components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/GatewayFeatureCatalog.java

+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
/*
2+
* Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
3+
*
4+
* WSO2 LLC. licenses this file to you under the Apache License,
5+
* Version 2.0 (the "License"); you may not use this file except
6+
* in compliance with the License.
7+
* You may obtain a copy of the License at
8+
*
9+
* http://www.apache.org/licenses/LICENSE-2.0
10+
*
11+
* Unless required by applicable law or agreed to in writing,
12+
* software distributed under the License is distributed on an
13+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
* KIND, either express or implied. See the License for the
15+
* specific language governing permissions and limitations
16+
* under the License.
17+
*/
18+
19+
package org.wso2.carbon.apimgt.api.model;
20+
21+
import java.util.HashMap;
22+
import java.util.List;
23+
import java.util.Map;
24+
25+
public class GatewayFeatureCatalog {
26+
27+
private Map<String, Object> gatewayFeatures = new HashMap<String, Object>();
28+
private Map<String, List<String>> apiTypes = new HashMap<String, List<String>>();
29+
30+
public Map<String, Object> getGatewayFeatures() {
31+
return gatewayFeatures;
32+
}
33+
34+
public void setGatewayFeatures(Map<String, Object> gatewayFeatures) {
35+
this.gatewayFeatures = gatewayFeatures;
36+
}
37+
38+
public Map<String, List<String>> getApiTypes() {
39+
return apiTypes;
40+
}
41+
42+
public void setApiTypes(Map<String, List<String>> apiTypes) {
43+
this.apiTypes = apiTypes;
44+
}
45+
}

0 commit comments

Comments
 (0)