forked from community/device-mgt-core
prabathabey
10 years ago
parent
14e7be6146
commit
e6d74ac9b4
@ -0,0 +1,51 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.app.mgt;
|
||||
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
import org.wso2.carbon.device.mgt.core.internal.DeviceManagementDataHolder;
|
||||
|
||||
public class AppManagementServiceImpl implements AppManagerConnector {
|
||||
|
||||
@Override
|
||||
public Application[] getApplicationList(String domain, int pageNumber,
|
||||
int size) throws AppManagerConnectorException {
|
||||
return DeviceManagementDataHolder.getInstance().getAppManager()
|
||||
.getApplicationList(domain, pageNumber, size);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void updateApplicationStatus(
|
||||
DeviceIdentifier deviceId, Application application, String status) throws AppManagerConnectorException {
|
||||
DeviceManagementDataHolder.getInstance().getAppManager().updateApplicationStatus(deviceId, application, status);
|
||||
|
||||
}
|
||||
|
||||
@Override
|
||||
public String getApplicationStatus(DeviceIdentifier deviceId,
|
||||
Application application) throws AppManagerConnectorException {
|
||||
return null;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Credential getClientCredentials() throws AppManagerConnectorException {
|
||||
return DeviceManagementDataHolder.getInstance().getAppManager().getClientCredentials();
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,71 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.app.mgt;
|
||||
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
|
||||
/**
|
||||
* This will handle the Application management side of MDM by acting a bridge between
|
||||
* MDM and App manager product.
|
||||
*/
|
||||
public interface AppManagerConnector {
|
||||
|
||||
/**
|
||||
* This will communicate with App manager and retrieve the list of apps in the store, when
|
||||
* the domain is given. The list is broken down into pages and retrieved.
|
||||
*
|
||||
* @param domain Tenant domain of the app list to be retrieved.
|
||||
* @param pageNumber Page number of the list.
|
||||
* @param size Number of items in one page.
|
||||
* @return The list of applications belongs to a domain.
|
||||
* @throws AppManagerConnectorException
|
||||
*/
|
||||
|
||||
Application[] getApplicationList(String domain, int pageNumber, int size) throws AppManagerConnectorException;
|
||||
|
||||
|
||||
/**
|
||||
* Updates the application, install/uninstall status of the a certain application, on a device.
|
||||
*
|
||||
* @param deviceId Device id of the device that the status belongs to.
|
||||
* @param application Application details of the app being updated.
|
||||
* @param status Installed/Uninstalled
|
||||
*/
|
||||
void updateApplicationStatus(DeviceIdentifier deviceId, Application application,
|
||||
String status) throws AppManagerConnectorException;
|
||||
|
||||
/**
|
||||
* Retrieve the status of an application on a device. Whether it is installed or not.
|
||||
*
|
||||
* @param deviceId Device id of the device that the status belongs to.
|
||||
* @param application Application details of the app being searched.
|
||||
* @return Status of the application on the device.
|
||||
*/
|
||||
String getApplicationStatus(DeviceIdentifier deviceId, Application application) throws AppManagerConnectorException;
|
||||
|
||||
/**
|
||||
* Create a new application and return client Id and secret.
|
||||
*
|
||||
* @return consumer Id and consumer key.
|
||||
* * @throws AppManagerConnectorException
|
||||
*/
|
||||
Credential getClientCredentials() throws AppManagerConnectorException;
|
||||
|
||||
}
|
||||
@ -0,0 +1,29 @@
|
||||
/*
|
||||
* Copyright (c) 2015, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.app.mgt;
|
||||
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.config.AppManagementConfig;
|
||||
|
||||
public class AppManagerConnectorFactory {
|
||||
|
||||
public static AppManagerConnector getConnector(AppManagementConfig config) {
|
||||
return new RemoteAppManagerConnector(config);
|
||||
}
|
||||
|
||||
}
|
||||
@ -1,132 +0,0 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.app.mgt;
|
||||
|
||||
import org.apache.axis2.AxisFault;
|
||||
import org.apache.axis2.context.ConfigurationContext;
|
||||
import org.apache.axis2.context.ConfigurationContextFactory;
|
||||
import org.apache.commons.logging.Log;
|
||||
import org.apache.commons.logging.LogFactory;
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.DeviceManagementConstants;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.ServiceAuthenticator;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.config.AppManagementConfig;
|
||||
import org.wso2.carbon.device.mgt.core.config.DeviceConfigurationManager;
|
||||
import org.wso2.carbon.device.mgt.core.config.identity.IdentityConfigurations;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
import org.wso2.carbon.device.mgt.core.service.AppManager;
|
||||
import org.wso2.carbon.identity.oauth.stub.OAuthAdminServiceException;
|
||||
import org.wso2.carbon.identity.oauth.stub.OAuthAdminServiceStub;
|
||||
import org.wso2.carbon.identity.oauth.stub.dto.OAuthConsumerAppDTO;
|
||||
|
||||
import java.rmi.RemoteException;
|
||||
|
||||
/**
|
||||
* Implements AppManager interface
|
||||
*/
|
||||
public class AppManagerImplHttp implements AppManager {
|
||||
|
||||
private static Log log = LogFactory.getLog(AppManagerImplHttp.class);
|
||||
private static AppManagementConfig appManagementConfig;
|
||||
private static final String GET_APP_LIST_URL =
|
||||
"store/apis/assets/mobileapp?domain=carbon.super&page=1";
|
||||
private static String appManagerUrl;
|
||||
private static String consumerKey;
|
||||
private static String consumerSecret;
|
||||
|
||||
public AppManagerImplHttp(AppManagementConfig appManagementConfig) {
|
||||
this.appManagementConfig = appManagementConfig;
|
||||
this.appManagerUrl = appManagementConfig.getAppManagerUrl();
|
||||
this.consumerKey = appManagementConfig.getConsumerKey();
|
||||
this.consumerSecret = appManagementConfig.getConsumerSecret();
|
||||
}
|
||||
|
||||
@Override
|
||||
public Application[] getApplicationList(String domain, int pageNumber, int size)
|
||||
throws AppManagementException {
|
||||
return new Application[0];
|
||||
}
|
||||
|
||||
@Override public void updateApplicationStatusOnDevice(DeviceIdentifier deviceId,
|
||||
Application application, String status) {
|
||||
|
||||
}
|
||||
|
||||
@Override public String getApplicationStatusOnDevice(DeviceIdentifier deviceId,
|
||||
Application application) {
|
||||
return null;
|
||||
}
|
||||
|
||||
@Override public Credential getClientCredentials() throws AppManagementException {
|
||||
OAuthAdminServiceStub oAuthAdminServiceStub;
|
||||
OAuthConsumerAppDTO appDTO = new OAuthConsumerAppDTO();
|
||||
appDTO.setApplicationName(DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
appDTO.setGrantTypes(
|
||||
DeviceManagementConstants.AppManagement.OAUTH2_GRANT_TYPE_CLIENT_CREDENTIALS);
|
||||
appDTO.setOAuthVersion(DeviceManagementConstants.AppManagement.OAUTH_VERSION_2);
|
||||
IdentityConfigurations identityConfigurations =
|
||||
DeviceConfigurationManager.getInstance().getDeviceManagementConfig()
|
||||
.getDeviceManagementConfigRepository()
|
||||
.getIdentityConfigurations();
|
||||
String serverUrl = identityConfigurations.getServerUrl();
|
||||
String username = identityConfigurations.getAdminUsername();
|
||||
String password = identityConfigurations.getAdminPassword();
|
||||
String oauthAdminServiceUrl = serverUrl +
|
||||
DeviceManagementConstants.AppManagement.OAUTH_ADMIN_SERVICE;
|
||||
|
||||
try {
|
||||
ConfigurationContext configContext = ConfigurationContextFactory
|
||||
.createConfigurationContextFromFileSystem(null, null);
|
||||
oAuthAdminServiceStub = new OAuthAdminServiceStub(configContext, oauthAdminServiceUrl);
|
||||
|
||||
ServiceAuthenticator authenticator = ServiceAuthenticator.getInstance();
|
||||
authenticator.setAccessUsername(username);
|
||||
authenticator.setAccessPassword(password);
|
||||
authenticator.authenticate(oAuthAdminServiceStub._getServiceClient());
|
||||
|
||||
OAuthConsumerAppDTO createdAppData = null;
|
||||
try {
|
||||
createdAppData = oAuthAdminServiceStub.getOAuthApplicationDataByAppName(
|
||||
DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
}
|
||||
//application doesn't exist. Due to the way getOAuthApplicationDataByAppName has been
|
||||
//implemented, it throws an AxisFault if the App doesn't exist. Hence the catch.
|
||||
catch (AxisFault fault) {
|
||||
oAuthAdminServiceStub.registerOAuthApplicationData(appDTO);
|
||||
createdAppData = oAuthAdminServiceStub.getOAuthApplicationDataByAppName(
|
||||
DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
}
|
||||
|
||||
Credential credential = new Credential();
|
||||
credential.setConsumerKey(createdAppData.getOauthConsumerKey());
|
||||
credential.setConsumerSecret(createdAppData.getOauthConsumerSecret());
|
||||
return credential;
|
||||
} catch (RemoteException e) {
|
||||
String msg = "Error while registering a new application.";
|
||||
log.error(msg, e);
|
||||
throw new AppManagementException(msg, e);
|
||||
} catch (OAuthAdminServiceException e) {
|
||||
String msg = "Error while working with oauth admin services stub.";
|
||||
log.error(msg, e);
|
||||
throw new AppManagementException(msg, e);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
@ -0,0 +1,140 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.app.mgt;
|
||||
|
||||
import org.apache.axis2.AxisFault;
|
||||
import org.apache.axis2.context.ConfigurationContext;
|
||||
import org.apache.axis2.context.ConfigurationContextFactory;
|
||||
import org.apache.commons.logging.Log;
|
||||
import org.apache.commons.logging.LogFactory;
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.DeviceManagementConstants;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.config.AppManagementConfig;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.ServiceAuthenticator;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.config.DeviceConfigurationManager;
|
||||
import org.wso2.carbon.device.mgt.core.config.identity.IdentityConfigurations;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
import org.wso2.carbon.identity.oauth.stub.OAuthAdminServiceException;
|
||||
import org.wso2.carbon.identity.oauth.stub.OAuthAdminServiceStub;
|
||||
import org.wso2.carbon.identity.oauth.stub.dto.OAuthConsumerAppDTO;
|
||||
|
||||
import java.rmi.RemoteException;
|
||||
|
||||
/**
|
||||
* Implements AppManagerConnector interface
|
||||
*/
|
||||
public class RemoteAppManagerConnector implements AppManagerConnector {
|
||||
|
||||
private ConfigurationContext configCtx;
|
||||
private ServiceAuthenticator authenticator;
|
||||
private AppManagementConfig appManagementConfig;
|
||||
private IdentityConfigurations identityConfig;
|
||||
private String oAuthAdminServiceUrl;
|
||||
|
||||
private static final String GET_APP_LIST_URL = "store/apis/assets/mobileapp?domain=carbon.super&page=1";
|
||||
|
||||
private static final Log log = LogFactory.getLog(RemoteAppManagerConnector.class);
|
||||
|
||||
public RemoteAppManagerConnector(AppManagementConfig appManagementConfig) {
|
||||
this.appManagementConfig = appManagementConfig;
|
||||
this.authenticator =
|
||||
new ServiceAuthenticator(identityConfig.getAdminUsername(), identityConfig.getAdminPassword());
|
||||
this.identityConfig =
|
||||
DeviceConfigurationManager.getInstance().getDeviceManagementConfig().
|
||||
getDeviceManagementConfigRepository().getIdentityConfigurations();
|
||||
this.oAuthAdminServiceUrl =
|
||||
identityConfig.getServerUrl() + DeviceManagementConstants.AppManagement.OAUTH_ADMIN_SERVICE;
|
||||
try {
|
||||
this.configCtx = ConfigurationContextFactory.createConfigurationContextFromFileSystem(null, null);
|
||||
} catch (AxisFault e) {
|
||||
throw new IllegalArgumentException("Error occurred while initializing Axis2 Configuration Context. " +
|
||||
"Please check if an appropriate axis2.xml is provided", e);
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public Application[] getApplicationList(String domain, int pageNumber,
|
||||
int size) throws AppManagerConnectorException {
|
||||
return new Application[0];
|
||||
}
|
||||
|
||||
@Override
|
||||
public void updateApplicationStatus(DeviceIdentifier deviceId, Application application,
|
||||
String status) throws AppManagerConnectorException{
|
||||
|
||||
}
|
||||
|
||||
@Override
|
||||
public String getApplicationStatus(DeviceIdentifier deviceId,
|
||||
Application application) throws AppManagerConnectorException {
|
||||
return null;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Credential getClientCredentials() throws AppManagerConnectorException {
|
||||
OAuthConsumerAppDTO appInfo = this.getAppInfo();
|
||||
|
||||
Credential credential = new Credential();
|
||||
credential.setConsumerKey(appInfo.getOauthConsumerKey());
|
||||
credential.setConsumerSecret(appInfo.getOauthConsumerSecret());
|
||||
return credential;
|
||||
}
|
||||
|
||||
private OAuthConsumerAppDTO getAppInfo() throws AppManagerConnectorException {
|
||||
OAuthConsumerAppDTO appInfo = null;
|
||||
try {
|
||||
OAuthAdminServiceStub oAuthAdminServiceStub =
|
||||
new OAuthAdminServiceStub(configCtx, oAuthAdminServiceUrl);
|
||||
authenticator.authenticate(oAuthAdminServiceStub._getServiceClient());
|
||||
|
||||
try {
|
||||
appInfo = oAuthAdminServiceStub.getOAuthApplicationDataByAppName(
|
||||
DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
}
|
||||
//application doesn't exist. Due to the way getOAuthApplicationDataByAppName has been
|
||||
//implemented, it throws an AxisFault if the App doesn't exist. Hence the catch.
|
||||
catch (AxisFault fault) {
|
||||
oAuthAdminServiceStub.registerOAuthApplicationData(this.getRequestDTO());
|
||||
appInfo = oAuthAdminServiceStub.getOAuthApplicationDataByAppName(
|
||||
DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
}
|
||||
} catch (RemoteException e) {
|
||||
handleException("Error occurred while retrieving app info", e);
|
||||
} catch (OAuthAdminServiceException e) {
|
||||
handleException("Error occurred while invoking OAuth admin service stub", e);
|
||||
}
|
||||
return appInfo;
|
||||
}
|
||||
|
||||
private OAuthConsumerAppDTO getRequestDTO() {
|
||||
OAuthConsumerAppDTO appDTO = new OAuthConsumerAppDTO();
|
||||
appDTO.setApplicationName(DeviceManagementConstants.AppManagement.OAUTH_APPLICATION_NAME);
|
||||
appDTO.setGrantTypes(
|
||||
DeviceManagementConstants.AppManagement.OAUTH2_GRANT_TYPE_CLIENT_CREDENTIALS);
|
||||
appDTO.setOAuthVersion(DeviceManagementConstants.AppManagement.OAUTH_VERSION_2);
|
||||
return appDTO;
|
||||
}
|
||||
|
||||
private void handleException(String msg, Exception e) throws AppManagerConnectorException {
|
||||
log.error(msg, e);
|
||||
throw new AppManagerConnectorException(msg, e);
|
||||
}
|
||||
|
||||
}
|
||||
@ -1,48 +0,0 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.service;
|
||||
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.AppManagementException;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
import org.wso2.carbon.device.mgt.core.internal.DeviceManagementDataHolder;
|
||||
|
||||
public class AppManagementServiceImpl implements AppManager {
|
||||
@Override public Application[] getApplicationList(String domain, int pageNumber, int size)
|
||||
throws AppManagementException {
|
||||
return DeviceManagementDataHolder.getInstance().getAppManager()
|
||||
.getApplicationList(domain, pageNumber, size);
|
||||
}
|
||||
|
||||
@Override public void updateApplicationStatusOnDevice(DeviceIdentifier deviceId,
|
||||
Application application, String status) {
|
||||
DeviceManagementDataHolder.getInstance().getAppManager()
|
||||
.updateApplicationStatusOnDevice(deviceId, application, status);
|
||||
|
||||
}
|
||||
|
||||
@Override public String getApplicationStatusOnDevice(DeviceIdentifier deviceId,
|
||||
Application application) {
|
||||
return null;
|
||||
}
|
||||
|
||||
@Override public Credential getClientCredentials() throws AppManagementException{
|
||||
return DeviceManagementDataHolder.getInstance().getAppManager().getClientCredentials();
|
||||
}
|
||||
}
|
||||
@ -1,69 +0,0 @@
|
||||
/*
|
||||
* Copyright (c) 2015 WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
|
||||
*
|
||||
* WSO2 Inc. 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.device.mgt.core.service;
|
||||
|
||||
import org.wso2.carbon.device.mgt.common.DeviceIdentifier;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.oauth.dto.Credential;
|
||||
import org.wso2.carbon.device.mgt.core.dto.Application;
|
||||
import org.wso2.carbon.device.mgt.core.app.mgt.AppManagementException;
|
||||
|
||||
/**
|
||||
* This will handle the Application management side of MDM by acting a bridge between
|
||||
* MDM and App manager product.
|
||||
*/
|
||||
public interface AppManager {
|
||||
|
||||
/**
|
||||
* This will communicate with App manager and retrieve the list of apps in the store, when
|
||||
* the domain is given. The list is broken down into pages and retrieved.
|
||||
* @param domain Tenant domain of the app list to be retrieved.
|
||||
* @param pageNumber Page number of the list.
|
||||
* @param size Number of items in one page.
|
||||
* @return The list of applications belongs to a domain.
|
||||
* @throws AppManagementException
|
||||
*/
|
||||
|
||||
Application [] getApplicationList(String domain, int pageNumber, int size)
|
||||
throws AppManagementException;
|
||||
|
||||
|
||||
/**
|
||||
* Updates the application, install/uninstall status of the a certain application, on a device.
|
||||
* @param deviceId Device id of the device that the status belongs to.
|
||||
* @param application Application details of the app being updated.
|
||||
* @param status Installed/Uninstalled
|
||||
*/
|
||||
void updateApplicationStatusOnDevice(DeviceIdentifier deviceId, Application application,
|
||||
String status);
|
||||
|
||||
/**
|
||||
* Retrieve the status of an application on a device. Whether it is installed or not.
|
||||
* @param deviceId Device id of the device that the status belongs to.
|
||||
* @param application Application details of the app being searched.
|
||||
* @return Status of the application on the device.
|
||||
*/
|
||||
String getApplicationStatusOnDevice(DeviceIdentifier deviceId, Application application);
|
||||
|
||||
/**
|
||||
* Create a new application and return client Id and secret.
|
||||
* @return consumer Id and consumer key.
|
||||
* * @throws AppManagementException
|
||||
*/
|
||||
Credential getClientCredentials() throws AppManagementException;
|
||||
}
|
||||
Loading…
Reference in new issue