---
title: 查询代码 - 原理
created: 2026-05-18
tags:
  - SAP
  - ADT
  - search
  - REST
parent: "[[sap-cli/README|SAP ADT 学习笔记总览]]"
prev: "[[sap-cli/01.ADT架构与通信原理|01.ADT架构与通信原理]]"
next: "[[sap-cli/03.修改代码-原理|03.修改代码 - 原理]]"
---

# 查询代码 — 原理

> [!abstract] 概述
> ADT 提供三种主要的代码查询能力：**仓库对象搜索**（按名称/类型）、**源代码全文搜索**（按代码片段）和 **Where-Used 导航**（引用追踪）。这些功能全部通过 `/sap/bc/adt/repository` 端点的 REST API 实现。

## 1. 仓库对象搜索 (Repository Object Search)

### 原理

通过 REST API 向 `/sap/bc/adt/repository/informationsystem/search` 发送 GET 请求，在后端 ABAP Repository 中搜索对象。

### REST API 调用

```
GET /sap/bc/adt/repository/informationsystem/search
    ?operation=quickSearch
    &query=<搜索关键词>
    &maxResults=50
    &objectType=<对象类型>   (可选)
```

### 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `operation` | 搜索操作类型 | `quickSearch` |
| `query` | 搜索关键词 | `ZCL_SALES*` |
| `maxResults` | 最大返回数量 | `50` |
| `objectType` | 对象类型过滤 | `CLAS`, `PROG`, `FUGR`, `TABL`, `DTEL`, `DOMA` |

### 响应格式

```xml
<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
           xmlns:is="http://www.sap.com/adt/repository/informationsystem">
  <is:object name="ZCL_SALES_ORDER"
             type="CLAS"
             uri="/sap/bc/adt/oo/classes/zcl_sales_order"
             packageName="Z_SALES"/>
</atom:feed>
```

### 后端处理流程

```
1. Eclipse 发送 GET 请求到 repository search 端点
2. ICF Handler 将请求路由到 ABAP Repository Search 类
3. 搜索引擎扫描 ABAP Repository（类似 SE80 搜索）
4. 返回匹配对象的元数据：名称、类型、URI、包名
5. Eclipse 在 Project Explorer 中展示搜索结果
6. 双击结果 → 通过 URI 加载对象的源代码编辑器
```

### 对应的 SAP GUI 事务码

| ADT 搜索 | SAP GUI 等效 |
|----------|-------------|
| 快速搜索 | `SE80` — Repository Browser |
| 按类型搜索 | `SE24`(类) / `SE38`(程序) / `SE37`(函数) |
| 按包搜索 | `SE80` — Package 节点 |

## 2. 源代码全文搜索 (ABAP Source Code Search)

### 原理

> [!info] 前置条件
> 源代码搜索需要激活业务功能 **`SRIS_SOURCE_SEARCH`**。

ADT 提供了一个 **搜索控制台**，允许在整个 ABAP 源码仓库中进行全文搜索，类似 IDE 中的 "Search in Files" 功能。

### 工作流程

```
1. 用户在 Eclipse 搜索控制台输入代码片段
   ↓
2. 客户端发送搜索请求到 ADT REST 端点
   ↓
3. 后端搜索引擎执行全文本索引查找
   ↓
4. 返回匹配的源码位置（对象名 + 行号）
   ↓
5. Eclipse 展示搜索结果，点击可直接跳转到编辑器
```

### 搜索能力

- **任意代码片段搜索** — 搜索变量名、方法调用、SQL 语句等
- **正则表达式支持** — 模式匹配搜索
- **范围限定** — 可限定搜索范围（包、对象类型等）
- **直接导航** — 搜索结果可直接跳转到对应的开发对象

### 对应 SAP GUI 的优势

在传统 SAP GUI 中，**不存在等效的全文本源码搜索功能**。这是 ADT 相对于 SE80 的重大改进之一。

## 3. 对象浏览与导航

### Repository Browser

```
GET /sap/bc/adt/repository/informationsystem
```

浏览 ABAP Repository 的层级结构：
- **按包浏览** — 展开包 → 查看其中所有对象
- **按类型浏览** — 按类、程序、表等类型分类
- **按传输层浏览** — 按传输层组织查看

### 对象详情获取

```
GET /sap/bc/adt/oo/classes/{class_name}
GET /sap/bc/adt/programs/programs/{program_name}
GET /sap/bc/adt/functions/groups/{group_name}
```

每个对象类型的详细信息通过对应的端点获取。

## 4. Where-Used 导航

### 原理

Where-Used 分析追踪对象在整个仓库中的引用关系。例如：查找哪些程序使用了某个类或方法。

### 处理流程

```
1. 用户在编辑器中选中一个标识符（类名/方法名/变量）
   ↓
2. Eclipse 发送 Where-Used 请求到 Repository 端点
   ↓
3. 后端 ABAP Runtime 执行交叉引用分析
   ↓
4. 返回所有引用位置（对象 + 行号 + 列号）
   ↓
5. Eclipse 展示引用列表，支持直接导航
```

### 对应的 SAP GUI 事务码

| ADT Where-Used | SAP GUI 等效 |
|----------------|-------------|
| 引用查找 | `SE80` → Where-Used List |
| 类型层次 | `SE24` → Superclass/Subclass |

## 5. 数据预览 (Data Preview)

### 原理

ADT 提供了表数据读取能力，可以替代传统的 SE16N 事务码。

### REST API 调用

```
POST /sap/bc/adt/datapreview/{table_name}
Content-Type: application/xml

<?xml version="1.0" encoding="utf-8"?>
<dataPreview:tableSettings
  xmlns:dataPreview="http://www.sap.com/adt/dataPreview">
  <dataPreview:column>*</dataPreview:column>
  <dataPreview:maxRows>100</dataPreview:maxRows>
</dataPreview:tableSettings>
```

### 优势对比

| 特性 | SE16N (SAP GUI) | ADT Data Preview |
|------|-----------------|-------------------|
| 访问方式 | 事务码，需要 SAP GUI | REST API，任何 HTTP 客户端 |
| 数据格式 | ALV Grid（屏幕渲染） | 结构化 XML/JSON |
| 并行查询 | 不支持 | 支持多线程并发 |
| 自动化 | 困难 | 可编程访问 |
| 平台限制 | Windows + SAP GUI | 任何平台 |

## 🔗 相关笔记

- [[sap-cli/01.ADT架构与通信原理|01.ADT架构与通信原理]]
- [[sap-cli/03.修改代码-原理|03.修改代码 - 原理]]

## 📚 参考来源

- [SAP Help Portal - Searching ABAP Source Code](https://help.sap.com/docs/abap-cloud/abap-development-tools-user-guide/searching-abap-source-code)
- [ABAP Source Code Search - SAP Community](https://community.sap.com/t5/application-development-blog-posts/abap-sourcecode-search/bc-p/13074593)
- [End-to-End SAP Automation with ADT REST Services](https://medium.com/@onuryz.itu/end-to-end-sap-automation-with-adt-rest-services-and-ai-a-modern-alternative-to-gui-scripting-343ea86064ea)