wso2 · piyumaldk · Jan 8, 2025 · Jan 10, 2025 · Jan 10, 2025 · Jan 16, 2025
@@ -545,9 +545,10 @@ boolean isScopeExists(String username, String scopeName)
      *
      * @param organization Organization name.
      * @param action       Action to perform ("PUBLISH" or "UNPUBLISH").
+     * @return Published or unpublished input stream.
      * @throws APIManagementException If a database error occurs.
      */
-    void updateOrgThemeStatus(String organization, String action) throws APIManagementException;
+    InputStream updateOrgThemeStatus(String organization, String action) throws APIManagementException;
 
     /**
      * Deletes an organization theme.

@@ -2176,10 +2176,10 @@ void importDraftedApiTheme(String organization, InputStream themeContent, String
      * @param organization Organization name.
      * @param action       Action to perform ("PUBLISH" or "UNPUBLISH").
      * @param apiId        API Identifier.
+     * @return Published or unpublished input stream.
      * @throws APIManagementException If a database error occurs.
      */
-    void updateApiThemeStatus(String organization, String action, String apiId)
-            throws APIManagementException;
+    InputStream updateApiThemeStatus(String organization, String action, String apiId) throws APIManagementException;
 
     /**
      * Deletes an API theme.

@@ -1689,8 +1689,8 @@ public void importDraftedOrgTheme(String organization, InputStream themeContent)
     }
 
     @Override
-    public void updateOrgThemeStatus(String organization, String action) throws APIManagementException {
-        apiMgtDAO.updateOrgThemeStatus(organization, action);
+    public InputStream updateOrgThemeStatus(String organization, String action) throws APIManagementException {
+        return apiMgtDAO.updateOrgThemeStatus(organization, action);
     }
 
     @Override

@@ -933,6 +933,10 @@ private Permissions() {
     public static final String API_DEVPORTAL_DEFAULT_RESERVED_USERNAME = API_STORE +
             "DefaultReservedUsername";
     public static final String API_STORE_CREATE_DEFAULT_APPLICATION = API_STORE + "CreateDefaultApplication";
+    public static final String API_STORE_NEW_PORTAL_ENABLED = API_STORE + "NewPortalEnabled";
+
+    public static final String API_STORE_TYPE = API_STORE + "PortalType";
+    public static final String API_STORE_ACCESS_URL = API_STORE + "PortalAccessURL";
 
     public static final String API_PUBLISHER = "APIPublisher.";
     public static final String SHOW_API_PUBLISHER_URL_FROM_STORE = API_PUBLISHER + "DisplayURL";

@@ -123,6 +123,7 @@
 import org.wso2.carbon.apimgt.impl.dao.ApiMgtDAO;
 import org.wso2.carbon.apimgt.impl.dao.GatewayArtifactsMgtDAO;
 import org.wso2.carbon.apimgt.impl.dao.ServiceCatalogDAO;
+import org.wso2.carbon.apimgt.impl.dao.constants.DevPortalConstants;
 import org.wso2.carbon.apimgt.impl.definitions.OAS3Parser;
 import org.wso2.carbon.apimgt.impl.definitions.OASParserUtil;
 import org.wso2.carbon.apimgt.impl.deployer.ExternalGatewayDeployer;
@@ -1057,6 +1058,22 @@ public API updateAPI(API api, API existingAPI) throws APIManagementException {
             recommendationThread.start();
         }
 
+        APIManagerConfiguration apiManagerConfiguration =
+                ServiceReferenceHolder.getInstance().getAPIManagerConfigurationService().getAPIManagerConfiguration();
+        String portalType = apiManagerConfiguration.getFirstProperty(APIConstants.API_STORE_TYPE);
+
+        if (DevPortalConstants.DEVPORTAL_V2.equals(portalType)) {
+            if (APIConstants.PUBLISHED.equals(api.getStatus())) {
+                try {
+                    DevPortalHandler devPortalHandler = DevPortalHandlerV2Impl.getInstance();
+                    String refId = apiMgtDAO.getRefId(api.getUuid(), organization);
+                    devPortalHandler.updateAPIMetadata(organization, api, refId);
+                } catch (APIManagementException e) {
+                    log.error(e.getMessage());
+                }
+            }
+        }
+
         return api;
     }
 
@@ -2659,6 +2676,21 @@ public void deleteAPI(String apiUuid, String organization) throws APIManagementE
                         wso2APIPublisher.deleteFromStore(api.getId(), APIUtil.getExternalAPIStore(store.getName(), tenantId));
                     }
                 }
+
+                APIManagerConfiguration apiManagerConfiguration =
+                        ServiceReferenceHolder.getInstance().getAPIManagerConfigurationService().getAPIManagerConfiguration();
+                String portalType = apiManagerConfiguration.getFirstProperty(APIConstants.API_STORE_TYPE);
+
+                if (DevPortalConstants.DEVPORTAL_V2.equals(portalType)) {
+                    DevPortalHandler devPortalHandler = DevPortalHandlerV2Impl.getInstance();
+                    try {
+                        String refId = apiMgtDAO.getRefId(api.getUuid(), organization);
+                        devPortalHandler.unpublishAPIMetadata(organization, api, refId);
+                        apiMgtDAO.removeRefId(api.getUuid(), organization);
+                    } catch (APIManagementException e) {
+                        log.error(e.getMessage());
+                    }
+                }
             } catch (APIManagementException e) {
                 log.error("Error while executing API delete operation on external API stores for API "
                         + apiUuid + " on organization " + organization, e);
@@ -8144,9 +8176,9 @@ public void importDraftedApiTheme(String organization, InputStream themeContent,
     }
 
     @Override
-    public void updateApiThemeStatus(String organization, String action, String apiId)
+    public InputStream updateApiThemeStatus(String organization, String action, String apiId)
             throws APIManagementException {
-        apiMgtDAO.updateApiThemeStatus(organization, action, apiId);
+        return apiMgtDAO.updateApiThemeStatus(organization, action, apiId);
     }
 
     @Override

@@ -0,0 +1,100 @@
+/*
+ *  Copyright (c) 2025, WSO2 LLC. (http://www.wso2.org) All Rights Reserved.
+ *
+ *  WSO2 LLC. 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.wso2.carbon.apimgt.impl;
+
+import org.apache.commons.lang3.StringUtils;
+import org.wso2.carbon.apimgt.api.model.ApiTypeWrapper;
+import org.wso2.carbon.apimgt.api.model.API;
+import org.wso2.carbon.apimgt.api.APIManagementException;
+import org.wso2.carbon.apimgt.impl.internal.ServiceReferenceHolder;
+
+import java.io.InputStream;
+
+/**
+ * This interface used to handle different types of developer portals' interactions with APIM.
+ */
+public interface DevPortalHandler {
+
+    /**
+     * Publishes API metadata to the Developer Portal.
+     *
+     * @param organization The organization to which the API belongs.
+     * @param api          The API object containing metadata details.
+     * @return A reference ID (Devportal side) of API.
+     * @throws APIManagementException If an error occurs while publishing metadata.
+     */
+    String publishAPIMetadata(String organization, API api) throws APIManagementException;
+
+    /**
+     * Updates API metadata in the Developer Portal.
+     *
+     * @param organization The organization to which the API belongs.
+     * @param api          The API object containing updated metadata.
+     * @param refId        The reference ID of the API to be updated.
+     * @throws APIManagementException If an error occurs while updating metadata.
+     */
+    void updateAPIMetadata(String organization, API api, String refId) throws APIManagementException;
+
+    /**
+     * Un-publishes API metadata from the Developer Portal.
+     *
+     * @param organization The organization to which the API belongs.
+     * @param api          The API object whose metadata is to be removed.
+     * @param refId        The reference ID of the API to be unpublished.
+     * @throws APIManagementException If an error occurs while un-publishing metadata.
+     */
+    void unpublishAPIMetadata(String organization, API api, String refId) throws APIManagementException;
+
+    /**
+     * Publishes API content (e.g., documentation, descriptions) to the Developer Portal.
+     *
+     * @param organization The organization to which the API belongs.
+     * @param refId        The reference ID of the API.
+     * @param content      The InputStream containing the content to be published.
+     * @param apiName      The name of the API.
+     * @throws APIManagementException If an error occurs while publishing content.
+     */
+    void publishAPIContent(String organization, String refId, InputStream content, String apiName) throws APIManagementException;
+
+    /**
+     * Un-publishes API content from the Developer Portal.
+     *
+     * @param organization The organization to which the API belongs.
+     * @param refId        The reference ID of the API whose content is to be removed.
+     * @throws APIManagementException If an error occurs while un-publishing content.
+     */
+    void unpublishAPIContent(String organization, String refId) throws APIManagementException;
+
+    /**
+     * Publishes organization theme to the Developer Portal.
+     *
+     * @param organization The organization for which content is being published.
+     * @param content      The InputStream containing the content to be published.
+     * @throws APIManagementException If an error occurs while publishing organization content.
+     */
+    void publishOrgContent(String organization, InputStream content) throws APIManagementException;
+
+    /**
+     * Un-publishes organization-level content from the Developer Portal.
+     *
+     * @param organization The organization whose content is to be removed.
+     * @throws APIManagementException If an error occurs while un-publishing organization content.
+     */
+    void unpublishOrgContent(String organization) throws APIManagementException;
+}