---
title: Business Logic — KKW00130SF02DBean.clearListDataInstance()
file: source/koptWebB/src/eo/web/webview/KKW00130SF/KKW00130SF02DBean.java
fqn: eo.web.webview.KKW00130SF.KKW00130SF02DBean
lines: 1672-1681
loc: 10
---

# Business Logic — KKW00130SF02DBean.clearListDataInstance() [10 LOC]

| Field | Value |
|-------|-------|
| Fully Qualified Name | `eo.web.webview.KKW00130SF.KKW00130SF02DBean` |
| Layer | Web Component (Data Bean / Screen Controller) |
| Module | `KKW00130SF` (Package: `eo.web.webview.KKW00130SF`) |

## 1. Role

### KKW00130SF02DBean.clearListDataInstance()

This method serves as a **selective list data clearing utility** within the KKW00130SF screen data bean. Its business purpose is to selectively clear list-bound data instances (specifically, the "banpo haishi request control code" list used for return-judgment flags in the number portability cancellation request flow) based on a key parameter that identifies which list element category to clear. The method implements a **conditional dispatch pattern** where the `key` parameter acts as an item identifier that determines whether any clearing action is taken. If the key matches the special Japanese-string literal "番号廃止依頼制御コード" (Banpo Haishi Irai Seigyo Code / Number Portability Cancellation Request Control Code), the associated `bmp_haishi_req_ctrl_cd_list` list is cleared; otherwise, the method performs a no-op. This method follows the **facade delegation pattern** commonly found across the FUW00xxx screen bean hierarchy — multiple downstream screen beans (e.g., `FUW00901SFBean`, `FUW00919SFBean`, `FUW00931SFBean`, `FUW00957SFBean`, `FUW00964SFBean` variants) override or extend this method and delegate to `super.clearListDataInstance(key)` to reuse this base clearing behavior. The method's role in the larger system is a **shared screen lifecycle helper** invoked during screen initialization or reset operations to ensure stale list data from prior screen interactions does not persist into the current display cycle.

## 2. Processing Pattern (Detailed Business Logic)

```mermaid
flowchart TD
    START(["clearListDataInstance(key)"])
    COND["key != null?"]
    CHECK["key equals \"番号廃止依頼制御コード\""]
    CLEAR["bmp_haishi_req_ctrl_cd_list.clear()"]
    END_NODE(["Return void"])

    START --> COND
    COND -->|true| CHECK
    COND -->|false| END_NODE
    CHECK -->|true| CLEAR
    CHECK -->|false| END_NODE
    CLEAR --> END_NODE
```

**CRITICAL — Constant Resolution:**

This method uses a hardcoded Japanese string literal for the key comparison rather than a constant. The literal resolves as:

- `"番号廃止依頼制御コード"` — **Banpo Haishi Irai Seigyo Code**: Number Portability Cancellation Request Control Code. This is the internal item name (項目名) used as a key to identify the `bmp_haishi_req_ctrl_cd_list` data list. The item ID associated with this key is `bmp_haishi_req_ctrl_cd` (as referenced in getter/setter/accessor methods throughout the bean).

The processing flow:
1. Check if `key` is non-null (defensive guard against null pointer exceptions).
2. If non-null, compare `key` against the string literal `"番号廃止依頼制御コード"`.
3. If the comparison matches, invoke `clear()` on the `bmp_haishi_req_ctrl_cd_list` list instance, which empties the list of all `X33VDataTypeBeanInterface` elements.
4. If `key` is null or does not match, the method returns without performing any operation (no-op).

## 3. Parameter Analysis

| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| 1 | `key` | `String` | The item name (項目名) used to identify which list data instance to clear. When the value matches `"番号廃止依頼制御コード"` (Banpo Haishi Irai Seigyo Code), the corresponding control code list for number portability cancellation requests is cleared. Other key values result in a no-op. This key is passed by calling screens during screen reset or initialization phases. |

**Instance fields read by this method:**

| Field | Type | Business Description |
|-------|------|---------------------|
| `bmp_haishi_req_ctrl_cd_list` | `X33VDataTypeList` | The list holding banpo (number portability) haishi (cancellation/return) request control code data items. Each element is an `X33VDataTypeBeanInterface` instance representing a single row of return-judgment flag data. |

## 4. CRUD Operations / Called Services

| CRUD | SC / CBS | SC Code | Entity / DB | Operation Description |
|------|----------|---------|-------------|----------------------|
| - | `X33VDataTypeList.clear` | - | - | Clears all elements from the `bmp_haishi_req_ctrl_cd_list` data list. This is a local in-memory operation that removes all list-bound data items without interacting with the database. |

**Analysis:** This method performs no direct database operations (C/R/U/D). It only manipulates in-memory list data by clearing a bean-bound list. The `clear()` call on `X33VDataTypeList` empties the list of all `X33VDataTypeBeanInterface` elements, effectively resetting the screen's working data for the "番号廃止依頼制御コード" (Number Portability Cancellation Request Control Code) list item.

## 5. Dependency Trace

| # | Caller (Screen/Batch) | Call Chain (Full Path to this Method) | Terminal (SC / CRUD / Entity) |
|---|----------------------|--------------------------------------|-------------------------------|
| 1 | Screen:FUW00901 | `FUW00901SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 2 | Screen:FUW00917 | `FUW00917SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 3 | Screen:FUW00919 | `FUW00919SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 4 | Screen:FUW00927 | `FUW00927SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 5 | Screen:FUW00931 | `FUW00931SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 6 | Screen:FUW00957 | `FUW00957SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |
| 7 | Screen:FUW00964 | `FUW00964SFBean.clearListDataInstance(key)` -> `super.clearListDataInstance(key)` -> `KKW00130SF02DBean.clearListDataInstance` | `bmp_haishi_req_ctrl_cd_list.clear() [-]` |

**Note:** The `KKW00130SF02DBean` itself is instantiated and used by `KKW00130SFBean` (as shown in lines 21294-21689 of the parent bean). The method is called by the bean framework during screen lifecycle events (init/reset). The FUW00xxx screen beans inherit this method and delegate to `super.clearListDataInstance(key)`, indicating `KKW00130SF02DBean` is a base class in the inheritance hierarchy used by multiple downstream screens.

## 6. Per-Branch Detail Blocks

**Block 1** — [IF] `(key != null)` (L1677)

> Guard against null key parameter. If key is null, skip all processing and return immediately. This prevents NullPointerException when calling `key.equals()` in the nested block.

| # | Type | Code | Business Description |
|---|------|------|---------------------|
| 1 | EXEC | `key.equals("番号廃止依頼制御コード")` | Compare the key parameter against the hardcoded Japanese string literal for the Number Portability Cancellation Request Control Code item name |

**Block 1.1** — [IF] `(key.equals("番号廃止依頼制御コード"))` (L1679) [番号廃止依頼制御コード = "番号廃止依頼制御コード"] (L1679)

> If the key matches the banpo haishi control code item name, clear the associated data list. This list holds the return-judgment flag data for number portability cancellation requests.

| # | Type | Code | Business Description |
|---|------|------|---------------------|
| 1 | EXEC | `bmp_haishi_req_ctrl_cd_list.clear()` | Clear all elements from the banpo haishi request control code list. This removes all `X33VDataTypeBeanInterface` instances from the list, effectively resetting the screen's working data for this item. |

**Block 2** — [ELSE] (implicit, when `key == null`) (L1677)

> When key is null, the method returns without any action. This is a defensive no-op that prevents errors when the caller passes a null key.

| # | Type | Code | Business Description |
|---|------|------|---------------------|
| 1 | RETURN | `return;` | Return void without any operation |

## 7. Glossary

| Term | Type | Business Meaning |
|------|------|------------------|
| `番号廃止依頼制御コード` | Field | Banpo Haishi Irai Seigyo Code — Number Portability Cancellation Request Control Code. The internal item name (項目名) used as a key to identify the list data for number portability cancellation request control code data. |
| `bmp_haishi_req_ctrl_cd` | Field | Banpo (番号) Haishi (廃止) Irai (依頼) Seigyo (制御) Code — The item ID (項目ID) for the banpo haishi request control code list data instance. |
| `bmp_haishi_req_ctrl_cd_list` | Field | The `X33VDataTypeList` holding all banpo haishi request control code data items. Each element is a `X33VDataTypeBeanInterface` instance. |
| `X33VDataTypeList` | Class | View data type list — a framework-provided list container holding typed data bean instances for screen data binding. |
| `X33VDataTypeBeanInterface` | Interface | View data type bean interface — the contract that each list element must implement for data binding and serialization. |
| banpo (番号) | Business term | Number (in the context of telephone number portability / 番号変更) |
| haishi (廃止) | Business term | Cancellation — refers to cancellation of a service or number portability request. |
| FUW00xxx | Screen | Downstream screen beans that inherit from or delegate to `KKW00130SF02DBean` for shared clearing behavior. Examples include FUW00901SF, FUW00917SF, FUW00919SF, FUW00927SF, FUW00931SF, FUW00957SF, FUW00964SF. |
| KKW00130SF | Module | The screen module responsible for number portability cancellation request processing. |
| DBean | Abbreviation | Data Bean — a screen-scoped bean class that holds form data, view state, and business data for a specific screen. |