# 导入代码生成模型图
#### 功能介绍
上传Java/C++代码文件，导入代码生成模型图，支持上传.java/.h/.zip格式。
**导入文件后工程目录生成规则：**
- **单文件导入**：不生成目录结构，模型图直接创建在导入时选中的目标目录下。
- **Java 压缩包导入**：按各 Java 文件的 package 声明自动生成目录树（如 com.huawei.demo → 三级目录）。
- **C++ 压缩包导入**：按压缩包内的文件目录结构自动生成目录树（如 include/base/foo.h → 两级目录）。
 
#### URI
```
POST /v1/modelproject/{uuid}/code-engineering/import
```
#### 请求参数
表1Header参数 
| 参数          | 是否必选 | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token。通过调用[IAM服务获取用户Token接口](https://support.huaweicloud.com/api-iam/iam_30_0001.html)获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
表2Path参数 
| 参数   | 是否必选 | 参数类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| uuid | 是   | String | **参数解释**： 软件建模工程id。 通过[查询模型工程列表](https://support.huaweicloud.com/api-codeartsmodeling/zh-cn_topic_0000001982680958.html)接口获取，响应消息体content中的model_project_uuid就是软件建模工程id。 **约束限制**： 由数字、字母、'-'组成。 **取值范围**： 32/36位字符。 **默认取值**： 不涉及。 |
   
表3Query参数 
| 参数            | 是否必选  | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| version_uuid | 是     | String | **参数解释**： 分支uuid。master分支传空字符串。 通过[查询工程分支信息](https://support.huaweicloud.com/api-codeartsmodeling/zh-cn_topic_0000002759920080.html)获取。 **约束限制**： 由数字、字母、'-'组成。 **取值范围**： 空字符串、32/36位字符。 **默认取值**： 空字符串                                                              |
| package_uuid | 是   | String  | **参数解释**： 目标包uuid。 通过[查询工程树](https://support.huaweicloud.com/api-codeartsmodeling/zh-cn_topic_0000002789358687.html)接口获取，响应消息体content中的packages数组中的uuid就是包uuid。 **约束限制**： 由数字、字母、'-'组成。 **取值范围**： 32/36位字符。 **默认取值**： 不涉及。                                |
| language    | 是 | String | **参数解释**： 导入代码语言类型，当前仅支持Java、C++语言。 **约束限制**： 不涉及。 **取值范围**： - Java：Java代码  - Cpp：C++代码   **默认取值**： 不涉及。 |
   
表4formData参数 
| 参数  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| file | 是  | file | **参数解释**： 代码文件。 **约束限制**： 支持的文件类型：.java/.h/.zip。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 响应参数
**状态码： 200**
表5响应Body参数 
| 参数           | 参数类型     | 描述                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| status       | String | **参数解释**： 接口返回的状态信息 **取值范围**： success：执行成功， failed：执行失败。 |
| error_code | String   | **参数解释**： 错误码。 **取值范围**： 不涉及。                                                                                 |
| error_msg   | String   | **参数解释**： 错误描述。 **取值范围**： 不涉及。                                                                               |
| result       | Object     | **参数解释**： 响应对象。 **取值范围**： 不涉及。                                                                                 |
   
表6result参数 
| 参数 | 参数类型 | 描述                                                                                                                                                |
|:---|:---|:---|
| task_uuid                         | String                            | **参数解释**： 代码导入任务uuid。 **取值范围**： 不涉及。      |
| project_space_uuid               | String                            | **参数解释**： 软件建模工程id。 **取值范围**： 不涉及。 |
   
#### 请求示例
```
POST https://{endpoint}/v1/modelproject/0f88f6dc4da743a28f00420ab55f22d5/code-engineering/import?version_uuid&package_uuid=1dc8ff74155e48ceb5fca19b6910975b&language=Java
{
    "file":"test.java",  // formData文件
}
```
导入代码功能示例，请参考[如何生成模型元素代码](https://support.huaweicloud.com/codeartsmodeling_faq/modeling_faq_0002_2.html)。
#### 响应示例
**状态码： 200**
success
```
{
    "status": "success",
    "error_code": null,
    "error_msg": null,
    "result": {
        "task_uuid": "5d9d3b683c44426c80893271c77cfb35",
        "project_space_uuid": "0f88f6dc4da743a28f00420ab55f22d5"
    }
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | success |
   
#### 错误码
参考[错误码](https://support.huaweicloud.com/api-codeartsmodeling/zh-cn_topic_0000001982521394.html)。
