华为北向网管NCE开发教程（2）REST接口开发

华为北向网管NCE开发教程（1）闭坑选接口协议
华为北向网管NCE开发教程（2）REST接口开发
华为北向网管NCE开发教程（3）CORBA协议开发
华为北向网管NCE开发教程（4）（源代码+接口文档+jacorb）
假设你现在要开始华为北向接口REST协议之前，需要准备如环境

1准备工作

1.1环境准备

IP:		北向网管NCE的IP地址
端口：	31943	
	  	31945
	  	26335
地址：	
https://<IP>:31943   NCE管理系统
https://<IP>:31945   NCE运维系统
https://<IP>:26335 	 REST服务接口

1.2文档准备

准备如下一系列文档，以下文档不必齐全，其中《用户指南》、《REST API参考》为必须有

版本说明
首先得确定你对接的网管是那个版本，文档版本和NEC的版本最好保持一致，不保持一致，无法保证实际调用接口和接口版本一致
例如通过：登录：https://:31943，可以在NCE管理系统系统中查看你的接口文档版本和实际的NCE系统的版本是否一致。

1.3API测试工具

测试工具就比较简单了，比如postMan等接口测试工具就可以了，假设如果你们的开发电脑不能直接访问北向NCE的话（事实证明，很多情况下，确实不允许你们的开发电脑访问NCE的），只要REST接口也不怕，可以写一个程序，部署到服务器，然后服务器转发HTTP请求到NCE系统。
针对不能直接访问网管NCE的流程如下：

例如我是这样做的：
编写一个SpringBoot程序，集成了swagger，将改程序部署到服务器，然后找一台能访问服务器的电脑，打开我们的wagger接口测试页面。然后我们在这里组织我们请求网管NCE的参数
例如：请求网管NCE的地址、请求方式、请求参数、token。

服务器接收到请求以后，根据swagger提交的参数向网管NCE发起请求。

2配置工作

再次还是提一下，前提条件，能保证REST接口能用起来，否则，我建议你终止，换其他接口
参考《北向REST接口 用户指南》配置REST接口。

2.1检查license

1. 访问地址：https://运维面IP地址:31943
2. 选择“系统设置”App后，在主菜单中选择“系统设置 > License管理”
3. 然后查看License选项中，看license是否可用
4. 部分版本的NCE，选择License管理管理，发现只有纯文本介绍，没有license相关的具体内容，可以在右上角的搜索框里面搜索License，那儿可以进去。
5. 具体页面的最终效果如下，因为我在写这篇文章的时候，我也没办法访问网管NCE了。
   
   License 要想可用，必须保证 消耗量 / 容量，不能超过百分之20，容量超限百分之20以后，直接不能使用，得加钱！得加钱！得加钱！重要的事说三遍。

消耗量/容量  >  120% ，license将直接不能用
消耗量/容量  <  100% ，license一直可用
100%  <消耗量/容量  <  120% ，license只可以在用三个月

2.2配置REST接口

如图所示，在这里可以看到你当前使用的这个版本的NCE在配置NCE的时候，是否有哪些必须配置的

我这个版本中，可以看到除了3.2以外，都是非必选
备注： 3.2也可以非必选，在调用的时候，禁用SSL认证即可。后面会说

备注： 3.6需要注意，某些版本在配置3.6版本时，会弹框提示你，需要启动某某服务，则按照下面的《启动REST接口服务》操作中，去启动该服务即可。

2.3启动REST接口服务

具体操作，我就不多说了，看指南里面操作即可。

2.3创建REST接口服务的用户

详情见操作指南3.9，这一步不是必须，如果已经有这样的用户了，就不用创建，没有的话，还是需要创建

3调试工作

3.1API测试工具调试

3.1.1登录接口

通过接口文档找到登录接口，在该接口中，找到请求方式、请求地址、请求参数、

打开PostMan，设置请求参数为PUT，请求数据为Json，填入请求地址，填入请求参数

重点：由于在配置REST的时候，我们没有配置证书，因此我们需要在设置中，禁用SSL证书验证

由于楼主写文章的时候，我已经离开机房，或者客户现场了，总之就是我现在没办法访问网管NCE了，只能给你们以前我访问拿到的一些数据了，例如这是我之前调试拿到的返回报文。

{
    "accessSession": "x-lc1gjug9lglijvvv7tvsip3whhsbka0anzoapg7yhi04apc76l9cg6tgft7z1d9darpeqp2qhdo9qn89sbfzanqpurbxqlhdmp89irc9tdjsliqmakqkrxo8hc2oelc5",
    "roaRand": "ae136e1468ea024e3a61731c99947f5ea27e7d13005d6579",
    "expires": 1800,
    "additionalInfo": null
}

通过登录接口，我们就可以拿到token信息了

3.1.2查询所有机房

找到我们需要的接口，找到请求参数，请求地址，请求方式等

按照接口填写地址，请求方式，然后把上面我们的登录接口中获取到accessSession复制下来，在postMan的headers中，添加X-Auth-Token，即可发起请求

3.2代码调试

当我们使用代码调试（无法直接用postMan访问网管NCE），或者开始开始编写代码访问NCE采集数据的时候，其实就是我们用代码模拟postMan请求。

3.2.1登录接口

登录太简单了，就不说了。直接看代码

@Data
public class LoginReq {
	
	private String url;
	
	private String grantType;
	
	private String userName;
	
	private String value;
}

@Data
public class LoginRes {
	private String accessSession;//": "x-yyyyyyy",
	private String roaRand;//": "xxxxxxx",
	private int expires;//": 1800,
}

public String loginNce() {
	ResponseEntity<LoginRes> res = restTemplate.postForEntity(loginReq.getUrl(), loginReq, LoginRes.class);
	return res.getBody().getAccessSession();
}

3.2.2查询所有机房

除登录以外的接口，就稍微复杂点，因为在postman测试的时候，我们添加了X-Auth-Token并且禁用了SSL证书，因此，我们用代码请求的时候，也需要这样做

如下这个代码是我用来调试网管NCE接口，在部署服务器上转发的代码，主要是把wagger传过来的token，地址，url，请求方式，请求地址拿过来，构建一个http请求。你可以理解为，我在服务器上构建了一个类似postman的功能，，然后我把参数给服务器，服务器给我发起请求到网管NCE

@Data
public class ReqTest {
	@NotEmpty
	@ApiModelProperty("请求方式")
	private String method;
	
	@NotEmpty
	@ApiModelProperty("请求地址")
	private String url;
	
	private String token;
	
	@ApiModelProperty("请求参数")
	private Map<String, Object> body;
}

public Object restHuaweiNce(ReqTest req) {
	HttpHeaders headers = new HttpHeaders();
	headers.add("X-Auth-Token", req.getToken());
	headers.setContentType(MediaType.APPLICATION_JSON);
	HttpEntity<Object> reqEntity = new HttpEntity<>(req.getBody(), headers);
	HttpMethod method = HttpMethod.resolve(req.getMethod().toUpperCase());
	ResponseEntity<Object> res = restTemplate.exchange(req.getUrl(), method, reqEntity, Object.class);
	return res.getBody();
}

如果你能直接连网管NCE，或者正式开发，就不需要我这么麻烦了，直接用put、get、post即可，不过你也需求像上面一样，在headers 里面，添加X-Auth-Token

restTemplate.put(null, req);
restTemplate.getForEntity(null, null);
restTemplate.postForEntity(null, req, null);

到这里还不够，因为我们还没有禁用SSL

/**
 * @description:Rest配置
 * @author:hutao
 * @date:2022年3月5日
 */
@SpringBootConfiguration
public class RestTemplateConfig {
	/*
	@Bean
	public RestTemplate restTemplate() {
	    SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
	    factory.setConnectTimeout(10000);
	    factory.setReadTimeout(10000);
	    return new RestTemplate(factory);
	}*/
    
	/**
	 * @description:关闭SLL验证
	 * @author:hutao
	 * @date:2024年2月29日 下午3:46:19
	 */
	@Bean
    public RestTemplate restTemplate() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException {
        TrustStrategy acceptingTrustStrategy = (X509Certificate[] chain, String authType) -> true;
        SSLContext sslContext = org.apache.http.ssl.SSLContexts.custom().loadTrustMaterial(null, acceptingTrustStrategy).build();
        SSLConnectionSocketFactory csf = new SSLConnectionSocketFactory(sslContext);
        CloseableHttpClient httpClient = HttpClients.custom().setSSLSocketFactory(csf).build();
        HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
        factory.setHttpClient(httpClient);
        factory.setConnectTimeout(10000);
	    factory.setReadTimeout(10000);
        RestTemplate restTemplate = new RestTemplate(factory);
        return restTemplate;
    }
}

至此，华为北向网管NCE REST接口开发就到这里了，剩下的具体要调用哪个接口，我就没招了，毕竟那么多个接口，我也不能挨个调用，只能选一两个示例了。后面我还会讲CORBA，那个会超级恶心。