Chế độ giao diện
3.3. Độ Ghép Nối và Độ Gắn Kết (Coupling and Cohesion)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Mọi mục tiêu tối thượng của kiến trúc phần mềm từ xưa đến nay đều quy tụ về đúng một chân lý kinh điển: "Độ Gắn Kết Cao và Độ Ghép Nối Thấp" (High Cohesion & Low Coupling - Larry Constantine 1974). Một module có độ gắn kết cao (Functional Cohesion) chỉ tập trung giải quyết trọn vẹn một trách nhiệm duy nhất; trong khi việc giảm thiểu độ ghép nối từ các cấp độ tồi tệ (Content & Common Coupling) sang cấp độ lý tưởng (Data & Message Coupling) là ranh giới sống còn giúp bạn có thể sửa đổi, nâng cấp một thành phần mà không làm sụp đổ các thành phần còn lại. Khi thiết kế kiến trúc gói (Packages), hai định luật SDP (Phụ thuộc vào hướng ổn định) và SAP (Ổn định phải đi đôi với Trừu tượng) của Robert C. Martin cung cấp thước đo toán học định lượng
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
1.1. Ẩn dụ Đời sống: Dây Tai Nghe Bị Rối vs Ổ Cắm Điện Gia Đình
Hãy hình dung hai hiện tượng vật lý quen thuộc:
- Hệ thống có Độ Ghép Nối Cao (Tight Coupling - Cuộn dây tai nghe bị rối tung):
- Bạn để 5 chiếc tai nghe có dây trong balo. Khi lấy ra, chúng quấn chặt vào nhau thành một búi bùi nhùi.
- Bạn chỉ muốn rút chiếc tai nghe màu đen, nhưng khi kéo nó ra, cả 4 chiếc tai nghe còn lại đều bị giật theo và đứt dây!
- Trong phần mềm: Sửa một dòng code trong hàm tính thuế (
BillingService) lại làm sập tính năng đổi ảnh đại diện (UserProfileService) vì hai bên cùng can thiệp vào một biến toàn cục chung (Common Coupling).
- Hệ thống có Độ Gắn Kết Cao & Ghép Nối Thấp (High Cohesion, Loose Coupling - Ổ cắm điện âm tường):
- Ổ cắm điện trên tường chỉ làm đúng một việc duy nhất: Cung cấp dòng điện xoay chiều 220V chuẩn hóa (Functional Cohesion).
- Chiếc quạt máy, máy sấy tóc và máy tính xách tay đều có thể cắm vào ổ điện này thông qua phích cắm chuẩn 2 chấu (Interface / Data Coupling). Ổ cắm điện không cần biết thiết bị cắm vào là máy sấy hay laptop; và chiếc máy tính xách tay có thể rút phích cắm mang sang phòng khác mà không làm chiếc quạt bị ngừng quay!
graph TD
classDef high fill:#e8f5e9,stroke:#388e3c,stroke-width:2px;
classDef bad fill:#ffebee,stroke:#d32f2f,stroke-width:2px;
classDef metric fill:#e1f5fe,stroke:#0288d1,stroke-width:2px;
Root["BẢN ĐỒ ĐỘ GHÉP NỐI VÀ ĐỘ GẮN KẾT (COUPLING & COHESION)"]
Root --> C["1. Phân Phổ Độ Ghép Nối (Coupling Spectrum)"]:::bad
Root --> CN["2. Lý Thuyết Connascence (Meilir Page-Jones)"]:::metric
Root --> H["3. Phân Phổ Độ Gắn Kết (Cohesion Spectrum)"]:::high
Root --> PKG["4. Các Nguyên Lý Kiến Trúc Gói (SDP & SAP)"]:::metric
C --> C1["Content Coupling (Tồi Tệ Nhất: Chọc trực tiếp vào Private State)"]
C --> C2["Common / Global Coupling (Dùng chung Biến Toàn Cục / Shared DB)"]
C --> C3["Control Coupling (Truyền cờ boolean điều khiển if-else bên trong)"]
C --> C4["Stamp Coupling (Truyền cả Object lớn chỉ để dùng 1 trường)"]
C --> C5["Data Coupling (Chỉ truyền đúng dữ liệu cần thiết - Chuẩn Mực)"]
C --> C6["Message Coupling (Bất đồng bộ qua Hàng đợi - Tối Ưu)"]
H --> H1["Coincidental Cohesion (Tồi Tệ Nhất: Helper/Utils gom bừa bãi)"]
H --> H2["Logical Cohesion (Gom các hàm cùng kiểu thao tác: Parse mọi thứ)"]
H --> H3["Temporal Cohesion (Gom các hàm chạy cùng thời điểm: Init/Startup)"]
H --> H4["Functional Cohesion (Lý Tưởng: Chỉ làm đúng 1 nhiệm vụ duy nhất)"]
PKG --> PKG1["SDP (Stable Dependencies Principle: Phụ thuộc vào nơi Ổn định)"]
PKG --> PKG2["SAP (Stable Abstractions Principle: Ổn định phải Trừu tượng)"]
PKG --> PKG3["The Main Sequence Metric: D = |A + I - 1|"]
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Phân Cấp Các Cấp Độ Ghép Nối (Coupling Spectrum: Từ Tồi Tệ Nhất Đến Tốt Nhất)
Độ ghép nối (Coupling) đo lường mức độ phụ thuộc qua lại giữa hai module. Larry Constantine và Glenford Myers đã phân loại thành 6 cấp độ từ nguy hiểm nhất đến an toàn nhất:
┌─────────────────────────────────┬─────────────────────────────────┬──────────────────────────────────────────┐
│ Cấp Độ Ghép Nối (Coupling) │ Bản Chất Kỹ Thuật │ Đánh Giá Mức Độ Nguy Hiểm & Giải Pháp │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 1. **Content Coupling** │ Module A sửa trực tiếp biến nội │ **CỰC KỲ TỒI TỆ (Thảm Họa)**: Phá vỡ │
│ (Ghép nối nội dung) │ bộ hoặc nhảy vào giữa code của B│ tính đóng gói $100\%$. Bắt buộc cấm chỉ! │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 2. **Common Coupling** │ Hai hay nhiều modules cùng đọc │ **RẤT XẤU**: Biến toàn cục hoặc Shared DB│
│ (Ghép nối toàn cục) │ và ghi vào một Global Variable │ khiến khó truy vết ai đã làm thay đổi data│
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 3. **External Coupling** │ Các modules phụ thuộc vào một │ **TRUNG BÌNH - XẤU**: Thay đổi giao thức │
│ (Ghép nối ngoại vi) │ định dạng phần cứng/OS bên ngoài│ bên ngoài làm sập toàn bộ các modules │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 4. **Control Coupling** │ Module A truyền một cờ boolean │ **XẤU**: Module A chỉ đạo module B phải │
│ (Ghép nối điều khiển) │ để ép B chạy theo nhánh `if/else│ thực thi thế nào. Cần refactor đa hình! │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 5. **Stamp Coupling** │ Truyền nguyên cả cấu trúc dữ │ **CHẤP NHẬN ĐƯỢC**: Làm lộ thông tin thừa│
│ (Ghép nối cấu trúc) │ liệu lớn (Object) chỉ để lấy 1 số│ Cần bóc tách interface hẹp hơn. │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 6. **Data Coupling** │ Chỉ truyền đúng các giá trị │ **CHUẨN MỰC TỐT**: Các hàm giao tiếp độc │
│ (Ghép nối dữ liệu) │ nguyên thủy cần thiết (Parameters)│ lập, dễ dàng Unit Test độc lập. │
├─────────────────────────────────┼─────────────────────────────────┼──────────────────────────────────────────┤
│ 7. **Message / No Coupling** │ Giao tiếp bất đồng bộ qua bản tin│ **LÝ TƯỞNG NHẤT**: Hoàn toàn không biết │
│ (Ghép nối thông điệp) │ phi tập trung (Event Broker) │ sự tồn tại của nhau (Decoupled Runtime). │
└─────────────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2.2. Connascence — Lý Thuyết Ghép Nối Nâng Cao (Meilir Page-Jones)
Trong kỹ nghệ phần mềm hiện đại, Meilir Page-Jones đã nâng cấp khái niệm ghép nối thành lý thuyết Connascence (Sự cùng sinh / Cùng biến đổi): "Hai thành phần phần mềm có tính Connascence nếu sự thay đổi ở thành phần này đòi hỏi thành phần kia cũng phải thay đổi để duy trì tính đúng đắn của toàn hệ thống".
1. Static Connascence (Nhận biết lúc biên dịch / Compile-time)
- Connascence of Name (CoN): Hai bên phải thống nhất tên hàm/biến (Cấp độ nhẹ nhất, công cụ Refactor tự đổi được).
- Connascence of Type (CoT): Hai bên phải thống nhất kiểu dữ liệu (ví dụ truyền
inthaystring). - Connascence of Meaning (CoM): Hai bên cùng hiểu ngầm ý nghĩa một giá trị đặc biệt (Ví dụ:
status = 1là Active,status = -99là Đã xóa Magic Numbers nguy hiểm). - Connascence of Position (CoP): Thứ tự tham số truyền vào hàm:
createUser(name, email, age, address) Nếu đổi vị trí tham số sẽ gây lỗi âm thầm. - Connascence of Algorithm (CoA): Hai bên phải dùng chung một thuật toán mã hóa hoặc checksum (MD5, SHA-256) thì mới giải mã được.
2. Dynamic Connascence (Chỉ nhận biết lúc chạy / Runtime - Rất nguy hiểm)
- Connascence of Execution (CoE): Hàm A bắt buộc phải được gọi trước hàm B (Ví dụ: phải gọi
init()trước khi gọiconnect()). - Connascence of Timing (CoT): Hai tiến trình phải chạy trong một khoảng thời gian nhất định mới không bị dính Race Condition.
- Connascence of Values (CoV): Giá trị của biến ở node A phải tương thích với giá trị ở node B (Ví dụ: Cấu hình phân tán giữa 2 microservices).
2.3. Phân Cấp Các Cấp Độ Gắn Kết (Cohesion Spectrum: Từ Tồi Tệ Nhất Đến Tốt Nhất)
Độ gắn kết (Cohesion) đo lường mức độ các phần tử bên trong một module thuộc về nhau và cùng phục vụ một mục đích duy nhất:
flowchart TD
C1["1. Coincidental (Ngẫu Nhiên: Helper, Utils gom bừa bãi)"] --> C2["2. Logical (Logic: Gom các hàm cùng kiểu như Export All to PDF/CSV)"]
C2 --> C3["3. Temporal (Thời Gian: Khởi tạo cùng thời điểm Startup)"]
C3 --> C4["4. Procedural (Thủ Tục: Chạy theo các bước tuần tự 1, 2, 3)"]
C4 --> C5["5. Communicational (Truyền Thông: Thao tác trên cùng một tập Data)"]
C5 --> C6["6. Sequential (Tuần Tự: Output của bước này là Input bước sau)"]
C6 --> C7["7. Functional Cohesion (CHỨC NĂNG: Chỉ làm đúng 1 nhiệm vụ duy nhất - ĐỈNH CAO!)"]
classDef bad fill:#fee2e2,stroke:#ef4444;
classDef good fill:#dcfce7,stroke:#16a34a;
class C1,C2,C3 bad;
class C6,C7 good;
- Coincidental Cohesion (Thảm họa lớp
CommonUtils / GeneralHelper): Một class rác chứa cả hàm tính căn bậc hai, hàm format ngày tháng, và hàm gửi email! Các hàm này hoàn toàn không có bất kỳ mối liên hệ logic nào với nhau. - Functional Cohesion (Đỉnh cao của SRP): Mọi dòng code bên trong module đều phục vụ cho một chức năng cốt lõi duy nhất (Ví dụ:
XmlPayloadParserchỉ làm đúng việc phân tích cú pháp XML,BcryptPasswordHasherchỉ làm đúng việc băm mật khẩu).
2.4. Package Coupling Principles: SDP & SAP (Robert C. Martin - Uncle Bob)
Khi cấu trúc các Package / Thư mục trong dự án Backend lớn, Uncle Bob định nghĩa hai nguyên lý toán học để giữ hệ thống không bị mục rỗng:
quadrantChart
title Biểu Đồ Chuỗi Chính (The Main Sequence: Abstractness vs Instability)
x-axis "Ổn Định Tuyệt Đối (I = 0)" --> "Bất Ổn Định Tuyệt Đối (I = 1)"
y-axis "Cụ Thể Tuyệt Đối (A = 0)" --> "Trừu Tượng Tuyệt Đối (A = 1)"
quadrant-1 "Vùng Vô Dụng (Zone of Uselessness: Quá trừu tượng mà không ai dùng)"
quadrant-2 "The Main Sequence (Đường Cân Bằng Chuẩn Mực)"
quadrant-3 "Vùng Đau Khổ (Zone of Pain: Cứng nhắc, Cực khó sửa đổi)"
quadrant-4 "The Main Sequence (Đường Cân Bằng Chuẩn Mực)"
"Cơ sở dữ liệu lõi": [0.10, 0.10]
"Plugin giao diện Web": [0.90, 0.85]
"Interface chuẩn mực": [0.35, 0.65]
1. Stable Dependencies Principle (SDP - Nguyên Lý Phụ Thuộc Ổn Định)
- Định luật: "Hướng của các mối quan hệ phụ thuộc phải luôn luôn đi về phía của sự ổn định".
- Chỉ số Bất Ổn Định (Instability Metric
): (Afferent Coupling - Khách hàng): Số lượng package bên ngoài phụ thuộc vào package này. (Efferent Coupling - Nhà cung cấp): Số lượng package bên ngoài mà package này phải phụ thuộc vào. : Ổn định tuyệt đối (Nhiều người phụ thuộc vào nó, nó không phụ thuộc vào ai Rất khó thay đổi). : Bất ổn định tối đa (Không ai phụ thuộc vào nó, nó phụ thuộc vào nhiều nơi Rất dễ thay đổi).
2. Stable Abstractions Principle (SAP - Nguyên Lý Trừu Tượng Ổn Định)
- Định luật: "Một package càng ổn định (
) thì nó càng bắt buộc phải trừu tượng ( )". - Chỉ số Trừu Tượng (Abstractness Metric
): : Số lượng Interface và Abstract Class trong package. : Tổng số lượng Class trong package.
- Khoảng cách đến Chuỗi Chính (Distance from the Main Sequence
):- Một package lý tưởng phải nằm sát đường
. - Nếu
ở góc dưới ( ): Package rơi vào "Vùng Đau Khổ" (Zone of Pain): Quá nhiều nơi phụ thuộc vào nó nhưng nó lại viết bằng các class cụ thể cứng nhắc, khiến mỗi lần sửa đổi là một cơn ác mộng!
- Một package lý tưởng phải nằm sát đường
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Refactoring Control Coupling thành Polymorphic Strategy
Chương trình minh chứng cách loại bỏ mã hôi Control Coupling (Truyền cờ boolean điều khiển if-else bên trong hàm khác) và tái cấu trúc thành thiết kế ghép nối lỏng lẻo bằng C++20 Lambdas và Polymorphism:
cpp
// control_coupling_refactoring.cpp
// Biên dịch: g++ -std=c++20 -O3 control_coupling_refactoring.cpp -o control_coupling_refactoring
#include <iostream>
#include <string>
#include <vector>
#include <memory>
#include <functional>
// ============================================================================
// PHẢN MẪU THIẾT KẾ: CONTROL COUPLING (Truyền cờ boolean ép hàm phân nhánh)
// ============================================================================
class BadInvoiceService {
public:
void print_invoice(double amount, bool is_vip_customer, bool send_email) {
// Hàm bị Control Coupling: Bên ngoài điều khiển luồng nội bộ của hàm
double final_price = amount;
if (is_vip_customer) {
final_price *= 0.85; // Giảm giá VIP 15%
}
std::cout << "[BAD INVOICE] Hóa đơn: $" << final_price << "\n";
if (send_email) {
std::cout << " -> Âm thầm kích hoạt gửi email hóa đơn nội bộ...\n";
}
}
};
// ============================================================================
// THIẾT KẾ CHUẨN MỰC: DATA COUPLING & STRATEGY (Loại bỏ hoàn toàn Control Flag)
// ============================================================================
struct DiscountPolicy {
std::function<double(double)> apply_discount;
};
class CleanInvoiceService {
public:
// Chỉ nhận dữ liệu thuần túy (Data Coupling) và Strategy đã được cấu hình trước
double calculate_final_amount(double raw_amount, const DiscountPolicy& policy) {
return policy.apply_discount(raw_amount);
}
};
int main() {
std::cout << "=======================================================================\n";
std::cout << " REFACTORING CONTROL COUPLING SANG DATA / STRATEGY COUPLING \n";
std::cout << "=======================================================================\n\n";
// 1. Chạy thử nghiệm Phản mẫu Control Coupling
std::cout << "--- 1. CHẠY THỬ MÃ HÔI CONTROL COUPLING ---\n";
BadInvoiceService bad_svc;
bad_svc.print_invoice(100.0, true, true); // Các cờ boolean mơ hồ: true, true là gì?
// 2. Chạy thử nghiệm Thiết kế Sạch (Strategy Injection)
std::cout << "\n--- 2. CHẠY THỬ THIẾT KẾ SẠCH (DATA COUPLING) ---\n";
CleanInvoiceService clean_svc;
DiscountPolicy vip_discount{ [](double a) { return a * 0.85; } };
DiscountPolicy regular_discount{ [](double a) { return a * 1.0; } };
double vip_final = clean_svc.calculate_final_amount(100.0, vip_discount);
double regular_final = clean_svc.calculate_final_amount(100.0, regular_discount);
std::cout << "[CLEAN INVOICE] Hóa đơn VIP : $" << vip_final << "\n";
std::cout << "[CLEAN INVOICE] Hóa đơn Thường : $" << regular_final << "\n";
std::cout << "\n>>> KẾT QUẢ: Tách rời việc tính tiền và gửi email thành 2 trách nhiệm riêng,\n"
<< " loại bỏ hoàn toàn cờ boolean điều khiển nội bộ!\n";
return 0;
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Terminal Output Mẫu:
text
=======================================================================
REFACTORING CONTROL COUPLING SANG DATA / STRATEGY COUPLING
=======================================================================
--- 1. CHẠY THỬ MÃ HÔI CONTROL COUPLING ---
[BAD INVOICE] Hóa đơn: $85
-> Âm thầm kích hoạt gửi email hóa đơn nội bộ...
--- 2. CHẠY THỬ THIẾT KẾ SẠCH (DATA COUPLING) ---
[CLEAN INVOICE] Hóa đơn VIP : $85
[CLEAN INVOICE] Hóa đơn Thường : $100
>>> KẾT QUẢ: Tách rời việc tính tiền và gửi email thành 2 trách nhiệm riêng,
loại bỏ hoàn toàn cờ boolean điều khiển nội bộ!1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
3.2. Python 3.11+ Package Metrics Calculator: Instability ( ), Abstractness ( ) & Distance ( )
Chương trình minh chứng cách tính toán toán học các chỉ số kiến trúc của Robert C. Martin: Đo lường độ bất ổn định
python
#!/usr/bin/env python3
"""
package_metrics_analyzer.py
Công Cụ Tính Toán Toán Học Các Chỉ Số Package Coupling: SDP, SAP và The Main Sequence
"""
from dataclasses import dataclass
from typing import List
@dataclass
class PackageMetrics:
name: str
ca: int # Afferent Coupling: Số package bên ngoài phụ thuộc vào package này
ce: int # Efferent Coupling: Số package bên ngoài mà package này phụ thuộc vào
num_classes: int # Tổng số class cụ thể (Nc)
num_abstract: int # Số lượng interfaces / abstract classes (Na)
@property
def instability(self) -> float:
"""I = Ce / (Ca + Ce)"""
total = self.ca + self.ce
return (self.ce / total) if total > 0 else 0.0
@property
def abstractness(self) -> float:
"""A = Na / Nc"""
return (self.num_abstract / self.num_classes) if self.num_classes > 0 else 0.0
@property
def distance_from_main_sequence(self) -> float:
"""D = |A + I - 1|"""
return abs(self.abstractness + self.instability - 1.0)
def diagnose_zone(self) -> str:
d = self.distance_from_main_sequence
if d < 0.2:
return "THE MAIN SEQUENCE (Cân Bằng Hoàn Hảo)"
elif self.abstractness < 0.3 and self.instability < 0.3:
return "!!! VÙNG ĐAU KHỔ (ZONE OF PAIN: Quá cụ thể nhưng quá nhiều người phụ thuộc!) !!!"
elif self.abstractness > 0.7 and self.instability > 0.7:
return "VÙNG VÔ DỤNG (ZONE OF USELESSNESS: Quá trừu tượng nhưng không ai dùng)"
return "CHẤP NHẬN ĐƯỢC"
def main():
print("=" * 80)
print(" CÔNG CỤ PHÂN TÍCH TOÁN HỌC CHỈ SỐ PACKAGE COUPLING (SDP & SAP) ")
print("=" * 80)
packages = [
# Gói lõi cơ sở dữ liệu: Nhiều người dùng (Ca=20), không phụ thuộc ai (Ce=0), nhưng toàn class cụ thể (Na=0)
PackageMetrics("com.app.core.database", ca=20, ce=0, num_classes=15, num_abstract=0),
# Gói giao diện trừu tượng chuẩn mực: Ca=15, Ce=2, nhiều interface (Na=8)
PackageMetrics("com.app.domain.interfaces", ca=15, ce=2, num_classes=10, num_abstract=8),
# Gói Web Controllers ở ngoại vi: Không ai dùng (Ca=0), phụ thuộc nhiều nơi (Ce=12)
PackageMetrics("com.app.web.controllers", ca=0, ce=12, num_classes=12, num_abstract=1),
]
for pkg in packages:
print(f"\n[PHÂN TÍCH PACKAGE]: {pkg.name}")
print(f" - Phụ thuộc vào/ra : Ca = {pkg.ca} | Ce = {pkg.ce}")
print(f" - Bất Ổn Định (I) : {pkg.instability:.3f} (0: Rất Ổn Định, 1: Rất Bất Ổn)")
print(f" - Trừu Tượng (A) : {pkg.abstractness:.3f} (Tỷ lệ Interfaces: {pkg.num_abstract}/{pkg.num_classes})")
print(f" - Khoảng Cách (D) : {pkg.distance_from_main_sequence:.3f} (Càng gần 0 càng chuẩn)")
print(f" >>> CHẨN ĐOÁN : {pkg.diagnose_zone()}")
print("\n" + "=" * 80)
if __name__ == "__main__":
main()1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
Terminal Output Mẫu:
text
================================================================================
CÔNG CỤ PHÂN TÍCH TOÁN HỌC CHỈ SỐ PACKAGE COUPLING (SDP & SAP)
================================================================================
[PHÂN TÍCH PACKAGE]: com.app.core.database
- Phụ thuộc vào/ra : Ca = 20 | Ce = 0
- Bất Ổn Định (I) : 0.000 (0: Rất Ổn Định, 1: Rất Bất Ổn)
- Trừu Tượng (A) : 0.000 (Tỷ lệ Interfaces: 0/15)
- Khoảng Cách (D) : 1.000 (Càng gần 0 càng chuẩn)
>>> CHẨN ĐOÁN : !!! VÙNG ĐAU KHỔ (ZONE OF PAIN: Quá cụ thể nhưng quá nhiều người phụ thuộc!) !!!
[PHÂN TÍCH PACKAGE]: com.app.domain.interfaces
- Phụ thuộc vào/ra : Ca = 15 | Ce = 2
- Bất Ổn Định (I) : 0.118 (0: Rất Ổn Định, 1: Rất Bất Ổn)
- Trừu Tượng (A) : 0.800 (Tỷ lệ Interfaces: 8/10)
- Khoảng Cách (D) : 0.082 (Càng gần 0 càng chuẩn)
>>> CHẨN ĐOÁN : THE MAIN SEQUENCE (Cân Bằng Hoàn Hảo)
[PHÂN TÍCH PACKAGE]: com.app.web.controllers
- Phụ thuộc vào/ra : Ca = 0 | Ce = 12
- Bất Ổn Định (I) : 1.000 (0: Rất Ổn Định, 1: Rất Bất Ổn)
- Trừu Tượng (A) : 0.083 (Tỷ lệ Interfaces: 1/12)
- Khoảng Cách (D) : 0.083 (Càng gần 0 càng chuẩn)
>>> CHẨN ĐOÁN : THE MAIN SEQUENCE (Cân Bằng Hoàn Hảo)
================================================================================1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
4. Systems Engineering & Production Pitfalls
4.1. Cạm Bẫy Thực Chiến Thường Gặp (Production Pitfalls)
1. Sự Cố "Zone of Pain" Khiến Toàn Đội Không Thể Refactor
- Hiện tượng: Một class
CoreEntity.javanằm ở đáy kiến trúc có (Toàn bộ 50 microservices phụ thuộc vào nó), nhưng (Nó là một class cụ thể chứa hàng nghìn dòng code logic thô). - Hậu quả: Khi một yêu cầu nghiệp vụ mới đòi hỏi sửa đổi một phương thức của
CoreEntity, rủi ro sập hệ thống lớn đến mức không một lập trình viên nào dám động vào, biến nó thành một "khối u di căn" của dự án. - Giải pháp: Tách
CoreEntitythành một Interface trừu tượng ( ) và sử dụng Dependency Inversion.
2. Thảm Họa "God Class / Kitchen Sink Utility"
- Hiện tượng: Class
StringHelperhoặcSystemManagerphình to lên 10.000 dòng code với Cohesion ngẫu nhiên (Coincidental Cohesion). - Hậu quả: Bất kỳ pull request nào cũng chạm vào file này, gây ra Merge Conflict liên tục và làm thời gian chạy Unit Test kéo dài hàng chục phút.
- Giải pháp: Chia nhỏ class theo các miền trách nhiệm cụ thể:
DateFormatter,UrlSanitizer,PasswordValidator.
3. Bẫy "Connascence of Position" Khi Tham Số Hàm Vượt Quá 5 Biến
- Hiện tượng: Hàm
processPayment(userId, merchantId, amount, tax, fee, currency, isRefund, discount)có 8 tham số cùng kiểu dữ liệu. - Hậu quả: Lập trình viên vô tình đảo nhầm vị trí giữa
amountvàtax, gây ra lỗi tính tiền sai lệch hàng tháng trời mà compiler không hề báo lỗi! - Giải pháp: Gom các tham số thành một Parameter Object / DTO có tên thuộc tính tường minh.
4.2. CLI Diagnostics & Công Cụ Đo Lường Coupling
bash
# 1. Phân tích ma trận phụ thuộc giữa các Packages bằng JDepend
jdepend-ui src/
# 2. Đo lường chỉ số khớp nối Afferent/Efferent coupling bằng PyCG hoặc Radon
radon raw -s src/
# 3. Quét tìm các hàm có danh sách tham số quá dài (Long Parameter List)
lizard src/ -a 51
2
3
4
5
6
7
8
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
| Chiều Không Gian So Sánh | Cấp Độ Tồi Tệ (Cần Loại Bỏ) | Cấp Độ Tốt (Chuẩn Mực) | Cấp Độ Lý Tưởng (Phân Tán) |
|---|---|---|---|
| Phổ Ghép Nối (Coupling) | Content Coupling, Common Coupling | Data Coupling (Truyền Parameters hẹp) | Message Coupling (Event Bus bất đồng bộ) |
| Phổ Gắn Kết (Cohesion) | Coincidental Cohesion (Utils/Helper) | Sequential / Communicational Cohesion | Functional Cohesion (Single Responsibility) |
| Vị Trí Trên Chuỗi Chính | Zone of Pain ( | Main Sequence ( | Main Sequence ( |
| Tác Động Khi Sửa Code | Lỗi lan truyền domino toàn hệ thống | Chỉ ảnh hưởng trong phạm vi module | Hoàn toàn cô lập, không ảnh hưởng ai |
| Độ Khó Khi Viết Unit Test | Phải dựng toàn bộ hệ thống giả lập | Dễ dàng Mocking qua Interface | Cực kỳ đơn giản, kiểm thử độc lập |
IyAzLjMuIMSQ4buZIEdow6lwIE7hu5FpIHbDoCDEkOG7mSBH4bqvbiBL4bq/dCAoQ291cGxpbmcgYW5kIENvaGVzaW9uKQ0KDQo+IFshSU1QT1JUQU5UXQ0KPiAqKk7hur91IGLhuqFuIGNo4buJIMSRxrDhu6NjIG5o4bubIG3hu5l0IMSRaeG7gXUgZHV5IG5o4bqldDoqKiBN4buNaSBt4bulYyB0acOqdSB04buRaSB0aMaw4bujbmcgY+G7p2Ega2nhur9uIHRyw7pjIHBo4bqnbiBt4buBbSB04burIHjGsGEgxJHhur9uIG5heSDEkeG7gXUgcXV5IHThu6UgduG7gSDEkcO6bmcgbeG7mXQgY2jDom4gbMO9IGtpbmggxJFp4buDbjogKioixJDhu5kgR+G6r24gS+G6v3QgQ2FvIHbDoCDEkOG7mSBHaMOpcCBO4buRaSBUaOG6pXAiIChIaWdoIENvaGVzaW9uICYgTG93IENvdXBsaW5nIC0gTGFycnkgQ29uc3RhbnRpbmUgMTk3NCkqKi4gTeG7mXQgbW9kdWxlIGPDsyDEkeG7mSBn4bqvbiBr4bq/dCBjYW8gKCoqRnVuY3Rpb25hbCBDb2hlc2lvbioqKSBjaOG7iSB04bqtcCB0cnVuZyBnaeG6o2kgcXV54bq/dCB0cuG7jW4gduG6uW4gbeG7mXQgdHLDoWNoIG5oaeG7h20gZHV5IG5o4bqldDsgdHJvbmcga2hpIHZp4buHYyBnaeG6o20gdGhp4buDdSDEkeG7mSBnaMOpcCBu4buRaSB04burIGPDoWMgY+G6pXAgxJHhu5kgdOG7k2kgdOG7hyAoKipDb250ZW50ICYgQ29tbW9uIENvdXBsaW5nKiopIHNhbmcgY+G6pXAgxJHhu5kgbMO9IHTGsOG7n25nICgqKkRhdGEgJiBNZXNzYWdlIENvdXBsaW5nKiopIGzDoCByYW5oIGdp4bubaSBz4buRbmcgY8OybiBnacO6cCBi4bqhbiBjw7MgdGjhu4Mgc+G7rWEgxJHhu5VpLCBuw6JuZyBj4bqlcCBt4buZdCB0aMOgbmggcGjhuqduIG3DoCBraMO0bmcgbMOgbSBz4bulcCDEkeG7lSBjw6FjIHRow6BuaCBwaOG6p24gY8OybiBs4bqhaS4gS2hpIHRoaeG6v3Qga+G6vyBraeG6v24gdHLDumMgZ8OzaSAoUGFja2FnZXMpLCBoYWkgxJHhu4tuaCBsdeG6rXQgKipTRFAgKFBo4bulIHRodeG7mWMgdsOgbyBoxrDhu5tuZyDhu5VuIMSR4buLbmgpKiogdsOgICoqU0FQICjhu5RuIMSR4buLbmggcGjhuqNpIMSRaSDEkcO0aSB24bubaSBUcuG7q3UgdMaw4bujbmcpKiogY+G7p2EgUm9iZXJ0IEMuIE1hcnRpbiBjdW5nIGPhuqVwIHRoxrDhu5tjIMSRbyB0b8OhbiBo4buNYyDEkeG7i25oIGzGsOG7o25nICREID0gfEEgKyBJIC0gMXwkIMSR4buDIG5nxINuIGNo4bq3biBjw6FjICJWw7luZyDEkGF1IEto4buVIiAoWm9uZSBvZiBQYWluKSB0cm9uZyBo4buHIHRo4buRbmcuDQoNCi0tLQ0KDQojIyAxLiBLaeG6v24gdHLDumMgVOG7lW5nIHF1YW4gJiBNw7QgaMOsbmggVMawIGR1eSAoTWVudGFsIE1vZGVsKQ0KDQojIyMgMS4xLiDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogRMOieSBUYWkgTmdoZSBC4buLIFLhu5FpIHZzIOG7lCBD4bqvbSDEkGnhu4duIEdpYSDEkMOsbmgNCg0KSMOjeSBow6xuaCBkdW5nIGhhaSBoaeG7h24gdMaw4bujbmcgduG6rXQgbMO9IHF1ZW4gdGh14buZYzoNCi0gKipI4buHIHRo4buRbmcgY8OzIMSQ4buZIEdow6lwIE7hu5FpIENhbyAoVGlnaHQgQ291cGxpbmcgLSBDdeG7mW4gZMOieSB0YWkgbmdoZSBi4buLIHLhu5FpIHR1bmcpKio6DQogIC0gQuG6oW4gxJHhu4MgNSBjaGnhur9jIHRhaSBuZ2hlIGPDsyBkw6J5IHRyb25nIGJhbG8uIEtoaSBs4bqleSByYSwgY2jDum5nIHF14bqlbiBjaOG6t3QgdsOgbyBuaGF1IHRow6BuaCBt4buZdCBiw7ppIGLDuWkgbmjDuWkuDQogIC0gQuG6oW4gY2jhu4kgbXXhu5FuIHLDunQgY2hp4bq/YyB0YWkgbmdoZSBtw6B1IMSRZW4sIG5oxrBuZyBraGkga8OpbyBuw7MgcmEsIGPhuqMgNCBjaGnhur9jIHRhaSBuZ2hlIGPDsm4gbOG6oWkgxJHhu4F1IGLhu4sgZ2nhuq10IHRoZW8gdsOgIMSR4bupdCBkw6J5IQ0KICAtIFRyb25nIHBo4bqnbiBt4buBbTogU+G7rWEgbeG7mXQgZMOybmcgY29kZSB0cm9uZyBow6BtIHTDrW5oIHRodeG6vyAoYEJpbGxpbmdTZXJ2aWNlYCkgbOG6oWkgbMOgbSBz4bqtcCB0w61uaCBuxINuZyDEkeG7lWkg4bqjbmggxJHhuqFpIGRp4buHbiAoYFVzZXJQcm9maWxlU2VydmljZWApIHbDrCBoYWkgYsOqbiBjw7luZyBjYW4gdGhp4buHcCB2w6BvIG3hu5l0IGJp4bq/biB0b8OgbiBj4bulYyBjaHVuZyAoKipDb21tb24gQ291cGxpbmcqKikuDQotICoqSOG7hyB0aOG7kW5nIGPDsyDEkOG7mSBH4bqvbiBL4bq/dCBDYW8gJiBHaMOpcCBO4buRaSBUaOG6pXAgKEhpZ2ggQ29oZXNpb24sIExvb3NlIENvdXBsaW5nIC0g4buUIGPhuq9tIMSRaeG7h24gw6JtIHTGsOG7nW5nKSoqOg0KICAtIOG7lCBj4bqvbSDEkWnhu4duIHRyw6puIHTGsOG7nW5nIGNo4buJIGzDoG0gxJHDum5nIG3hu5l0IHZp4buHYyBkdXkgbmjhuqV0OiBDdW5nIGPhuqVwIGTDsm5nIMSRaeG7h24geG9heSBjaGnhu4F1IDIyMFYgY2h14bqpbiBow7NhIChGdW5jdGlvbmFsIENvaGVzaW9uKS4NCiAgLSBDaGnhur9jIHF14bqhdCBtw6F5LCBtw6F5IHPhuqV5IHTDs2MgdsOgIG3DoXkgdMOtbmggeMOhY2ggdGF5IMSR4buBdSBjw7MgdGjhu4MgY+G6r20gdsOgbyDhu5UgxJFp4buHbiBuw6B5IHRow7RuZyBxdWEgcGjDrWNoIGPhuq9tIGNodeG6qW4gMiBjaOG6pXUgKEludGVyZmFjZSAvIERhdGEgQ291cGxpbmcpLiDhu5QgY+G6r20gxJFp4buHbiBraMO0bmcgY+G6p24gYmnhur90IHRoaeG6v3QgYuG7iyBj4bqvbSB2w6BvIGzDoCBtw6F5IHPhuqV5IGhheSBsYXB0b3A7IHbDoCBjaGnhur9jIG3DoXkgdMOtbmggeMOhY2ggdGF5IGPDsyB0aOG7gyByw7p0IHBow61jaCBj4bqvbSBtYW5nIHNhbmcgcGjDsm5nIGtow6FjIG3DoCBraMO0bmcgbMOgbSBjaGnhur9jIHF14bqhdCBi4buLIG5n4burbmcgcXVheSENCg0KYGBgbWVybWFpZA0KZ3JhcGggVEQNCiAgICBjbGFzc0RlZiBoaWdoIGZpbGw6I2U4ZjVlOSxzdHJva2U6IzM4OGUzYyxzdHJva2Utd2lkdGg6MnB4Ow0KICAgIGNsYXNzRGVmIGJhZCBmaWxsOiNmZmViZWUsc3Ryb2tlOiNkMzJmMmYsc3Ryb2tlLXdpZHRoOjJweDsNCiAgICBjbGFzc0RlZiBtZXRyaWMgZmlsbDojZTFmNWZlLHN0cm9rZTojMDI4OGQxLHN0cm9rZS13aWR0aDoycHg7DQoNCiAgICBSb290WyJC4bqiTiDEkOG7kiDEkOG7mCBHSMOJUCBO4buQSSBWw4AgxJDhu5ggR+G6rk4gS+G6vlQgKENPVVBMSU5HICYgQ09IRVNJT04pIl0NCg0KICAgIFJvb3QgLS0+IENbIjEuIFBow6JuIFBo4buVIMSQ4buZIEdow6lwIE7hu5FpIChDb3VwbGluZyBTcGVjdHJ1bSkiXTo6OmJhZA0KICAgIFJvb3QgLS0+IENOWyIyLiBMw70gVGh1eeG6v3QgQ29ubmFzY2VuY2UgKE1laWxpciBQYWdlLUpvbmVzKSJdOjo6bWV0cmljDQogICAgUm9vdCAtLT4gSFsiMy4gUGjDom4gUGjhu5UgxJDhu5kgR+G6r24gS+G6v3QgKENvaGVzaW9uIFNwZWN0cnVtKSJdOjo6aGlnaA0KICAgIFJvb3QgLS0+IFBLR1siNC4gQ8OhYyBOZ3V5w6puIEzDvSBLaeG6v24gVHLDumMgR8OzaSAoU0RQICYgU0FQKSJdOjo6bWV0cmljDQoNCiAgICBDIC0tPiBDMVsiQ29udGVudCBDb3VwbGluZyAoVOG7k2kgVOG7hyBOaOG6pXQ6IENo4buNYyB0cuG7sWMgdGnhur9wIHbDoG8gUHJpdmF0ZSBTdGF0ZSkiXQ0KICAgIEMgLS0+IEMyWyJDb21tb24gLyBHbG9iYWwgQ291cGxpbmcgKETDuW5nIGNodW5nIEJp4bq/biBUb8OgbiBD4bulYyAvIFNoYXJlZCBEQikiXQ0KICAgIEMgLS0+IEMzWyJDb250cm9sIENvdXBsaW5nIChUcnV54buBbiBj4budIGJvb2xlYW4gxJFp4buBdSBraGnhu4NuIGlmLWVsc2UgYsOqbiB0cm9uZykiXQ0KICAgIEMgLS0+IEM0WyJTdGFtcCBDb3VwbGluZyAoVHJ1eeG7gW4gY+G6oyBPYmplY3QgbOG7m24gY2jhu4kgxJHhu4MgZMO5bmcgMSB0csaw4budbmcpIl0NCiAgICBDIC0tPiBDNVsiRGF0YSBDb3VwbGluZyAoQ2jhu4kgdHJ1eeG7gW4gxJHDum5nIGThu68gbGnhu4d1IGPhuqduIHRoaeG6v3QgLSBDaHXhuqluIE3hu7FjKSJdDQogICAgQyAtLT4gQzZbIk1lc3NhZ2UgQ291cGxpbmcgKELhuqV0IMSR4buTbmcgYuG7mSBxdWEgSMOgbmcgxJHhu6NpIC0gVOG7kWkgxq91KSJdDQoNCiAgICBIIC0tPiBIMVsiQ29pbmNpZGVudGFsIENvaGVzaW9uIChU4buTaSBU4buHIE5o4bqldDogSGVscGVyL1V0aWxzIGdvbSBi4burYSBiw6NpKSJdDQogICAgSCAtLT4gSDJbIkxvZ2ljYWwgQ29oZXNpb24gKEdvbSBjw6FjIGjDoG0gY8O5bmcga2nhu4N1IHRoYW8gdMOhYzogUGFyc2UgbeG7jWkgdGjhu6kpIl0NCiAgICBIIC0tPiBIM1siVGVtcG9yYWwgQ29oZXNpb24gKEdvbSBjw6FjIGjDoG0gY2jhuqF5IGPDuW5nIHRo4budaSDEkWnhu4NtOiBJbml0L1N0YXJ0dXApIl0NCiAgICBIIC0tPiBINFsiRnVuY3Rpb25hbCBDb2hlc2lvbiAoTMO9IFTGsOG7n25nOiBDaOG7iSBsw6BtIMSRw7puZyAxIG5oaeG7h20gduG7pSBkdXkgbmjhuqV0KSJdDQoNCiAgICBQS0cgLS0+IFBLRzFbIlNEUCAoU3RhYmxlIERlcGVuZGVuY2llcyBQcmluY2lwbGU6IFBo4bulIHRodeG7mWMgdsOgbyBuxqFpIOG7lG4gxJHhu4tuaCkiXQ0KICAgIFBLRyAtLT4gUEtHMlsiU0FQIChTdGFibGUgQWJzdHJhY3Rpb25zIFByaW5jaXBsZTog4buUbiDEkeG7i25oIHBo4bqjaSBUcuG7q3UgdMaw4bujbmcpIl0NCiAgICBQS0cgLS0+IFBLRzNbIlRoZSBNYWluIFNlcXVlbmNlIE1ldHJpYzogRCA9IHxBICsgSSAtIDF8Il0NCmBgYA0KDQotLS0NCg0KIyMgMi4gQ2hpIHRp4bq/dCB04burbmcgS2V5d29yZCAoVW5kZXItdGhlLUhvb2QgRGVlcCBEaXZlKQ0KDQojIyMgMi4xLiBQaMOibiBD4bqlcCBDw6FjIEPhuqVwIMSQ4buZIEdow6lwIE7hu5FpIChDb3VwbGluZyBTcGVjdHJ1bTogVOG7qyBU4buTaSBU4buHIE5o4bqldCDEkOG6v24gVOG7kXQgTmjhuqV0KQ0KDQrEkOG7mSBnaMOpcCBu4buRaSAoQ291cGxpbmcpIMSRbyBsxrDhu51uZyBt4bupYyDEkeG7mSBwaOG7pSB0aHXhu5ljIHF1YSBs4bqhaSBnaeG7r2EgaGFpIG1vZHVsZS4gTGFycnkgQ29uc3RhbnRpbmUgdsOgIEdsZW5mb3JkIE15ZXJzIMSRw6MgcGjDom4gbG/huqFpIHRow6BuaCA2IGPhuqVwIMSR4buZIHThu6sgbmd1eSBoaeG7g20gbmjhuqV0IMSR4bq/biBhbiB0b8OgbiBuaOG6pXQ6DQoNCmBgYA0K4pSM4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSs4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSs4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSQDQrilIIgQ+G6pXAgxJDhu5kgR2jDqXAgTuG7kWkgKENvdXBsaW5nKSAgICAgIOKUgiBC4bqjbiBDaOG6pXQgS+G7uSBUaHXhuq10ICAgICAgICAgICAgICAg4pSCIMSQw6FuaCBHacOhIE3hu6ljIMSQ4buZIE5ndXkgSGnhu4NtICYgR2nhuqNpIFBow6FwICAgIOKUgg0K4pSc4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pS84pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pS84pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSkDQrilIIgMS4gKipDb250ZW50IENvdXBsaW5nKiogICAgICAgICDilIIgTW9kdWxlIEEgc+G7rWEgdHLhu7FjIHRp4bq/cCBiaeG6v24gbuG7mWkg4pSCICoqQ+G7sEMgS+G7siBU4buSSSBU4buGIChUaOG6o20gSOG7jWEpKio6IFBow6EgduG7oSAgICAg4pSCDQrilIIgKEdow6lwIG7hu5FpIG7hu5lpIGR1bmcpICAgICAgICAgICAgIOKUgiBi4buZIGhv4bq3YyBuaOG6o3kgdsOgbyBnaeG7r2EgY29kZSBj4bunYSBC4pSCIHTDrW5oIMSRw7NuZyBnw7NpICQxMDBcJSQuIELhuq90IGJ14buZYyBj4bqlbSBjaOG7iSEg4pSCDQrilJzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilKQNCuKUgiAyLiAqKkNvbW1vbiBDb3VwbGluZyoqICAgICAgICAgIOKUgiBIYWkgaGF5IG5oaeG7gXUgbW9kdWxlcyBjw7luZyDEkeG7jWMgIOKUgiAqKlLhuqRUIFjhuqRVKio6IEJp4bq/biB0b8OgbiBj4bulYyBob+G6t2MgU2hhcmVkIERC4pSCDQrilIIgKEdow6lwIG7hu5FpIHRvw6BuIGPhu6VjKSAgICAgICAgICAgICDilIIgdsOgIGdoaSB2w6BvIG3hu5l0IEdsb2JhbCBWYXJpYWJsZSAg4pSCIGtoaeG6v24ga2jDsyB0cnV5IHbhur90IGFpIMSRw6MgbMOgbSB0aGF5IMSR4buVaSBkYXRh4pSCDQrilJzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLzilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilKQNCuKUgiAzLiAqKkV4dGVybmFsIENvdXBsaW5nKiogICAgICAgIOKUgiBDw6FjIG1vZHVsZXMgcGjhu6UgdGh14buZYyB2w6BvIG3hu5l0ICAg4pSCICoqVFJVTkcgQsOMTkggLSBY4bqkVSoqOiBUaGF5IMSR4buVaSBnaWFvIHRo4bupYyDilIINCuKUgiAoR2jDqXAgbuG7kWkgbmdv4bqhaSB2aSkgICAgICAgICAgICAg4pSCIMSR4buLbmggZOG6oW5nIHBo4bqnbiBj4bupbmcvT1MgYsOqbiBuZ2/DoGnilIIgYsOqbiBuZ2/DoGkgbMOgbSBz4bqtcCB0b8OgbiBi4buZIGPDoWMgbW9kdWxlcyAgICDilIINCuKUnOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUpA0K4pSCIDQuICoqQ29udHJvbCBDb3VwbGluZyoqICAgICAgICAg4pSCIE1vZHVsZSBBIHRydXnhu4FuIG3hu5l0IGPhu50gYm9vbGVhbiAg4pSCICoqWOG6pFUqKjogTW9kdWxlIEEgY2jhu4kgxJHhuqFvIG1vZHVsZSBCIHBo4bqjaSAg4pSCDQrilIIgKEdow6lwIG7hu5FpIMSRaeG7gXUga2hp4buDbikgICAgICAgICAgIOKUgiDEkeG7gyDDqXAgQiBjaOG6oXkgdGhlbyBuaMOhbmggYGlmL2Vsc2XilIIgdGjhu7FjIHRoaSB0aOG6vyBuw6BvLiBD4bqnbiByZWZhY3RvciDEkWEgaMOsbmghICDilIINCuKUnOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUpA0K4pSCIDUuICoqU3RhbXAgQ291cGxpbmcqKiAgICAgICAgICAg4pSCIFRydXnhu4FuIG5ndXnDqm4gY+G6oyBj4bqldSB0csO6YyBk4buvICAgIOKUgiAqKkNI4bqkUCBOSOG6rE4gxJDGr+G7okMqKjogTMOgbSBs4buZIHRow7RuZyB0aW4gdGjhu6th4pSCDQrilIIgKEdow6lwIG7hu5FpIGPhuqV1IHRyw7pjKSAgICAgICAgICAgICDilIIgbGnhu4d1IGzhu5tuIChPYmplY3QpIGNo4buJIMSR4buDIGzhuqV5IDEgc+G7keKUgiBD4bqnbiBiw7NjIHTDoWNoIGludGVyZmFjZSBo4bq5cCBoxqFuLiAgICAgICAgIOKUgg0K4pSc4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pS84pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pS84pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSkDQrilIIgNi4gKipEYXRhIENvdXBsaW5nKiogICAgICAgICAgICDilIIgQ2jhu4kgdHJ1eeG7gW4gxJHDum5nIGPDoWMgZ2nDoSB0cuG7iyAgICAg4pSCICoqQ0hV4bqoTiBN4buwQyBU4buQVCoqOiBDw6FjIGjDoG0gZ2lhbyB0aeG6v3AgxJHhu5ljIOKUgg0K4pSCIChHaMOpcCBu4buRaSBk4buvIGxp4buHdSkgICAgICAgICAgICAgIOKUgiBuZ3V5w6puIHRo4buneSBj4bqnbiB0aGnhur90IChQYXJhbWV0ZXJzKeKUgiBs4bqtcCwgZOG7hSBkw6BuZyBVbml0IFRlc3QgxJHhu5ljIGzhuq1wLiAgICAgICAgICDilIINCuKUnOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUvOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUpA0K4pSCIDcuICoqTWVzc2FnZSAvIE5vIENvdXBsaW5nKiogICAg4pSCIEdpYW8gdGnhur9wIGLhuqV0IMSR4buTbmcgYuG7mSBxdWEgYuG6o24gdGlu4pSCICoqTMOdIFTGr+G7nk5HIE5I4bqkVCoqOiBIb8OgbiB0b8OgbiBraMO0bmcgYmnhur90ICDilIINCuKUgiAoR2jDqXAgbuG7kWkgdGjDtG5nIMSRaeG7h3ApICAgICAgICAgICDilIIgcGhpIHThuq1wIHRydW5nIChFdmVudCBCcm9rZXIpICAgIOKUgiBz4buxIHThu5NuIHThuqFpIGPhu6dhIG5oYXUgKERlY291cGxlZCBSdW50aW1lKS4g4pSCDQrilJTilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLTilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilLTilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilJgNCmBgYA0KDQotLS0NCg0KIyMjIDIuMi4gQ29ubmFzY2VuY2Ug4oCUIEzDvSBUaHV54bq/dCBHaMOpcCBO4buRaSBOw6JuZyBDYW8gKE1laWxpciBQYWdlLUpvbmVzKQ0KDQpUcm9uZyBr4bu5IG5naOG7hyBwaOG6p24gbeG7gW0gaGnhu4duIMSR4bqhaSwgTWVpbGlyIFBhZ2UtSm9uZXMgxJHDoyBuw6JuZyBj4bqlcCBraMOhaSBuaeG7h20gZ2jDqXAgbuG7kWkgdGjDoG5oIGzDvSB0aHV54bq/dCAqKkNvbm5hc2NlbmNlKiogKFPhu7EgY8O5bmcgc2luaCAvIEPDuW5nIGJp4bq/biDEkeG7lWkpOiAqIkhhaSB0aMOgbmggcGjhuqduIHBo4bqnbiBt4buBbSBjw7MgdMOtbmggQ29ubmFzY2VuY2UgbuG6v3Ugc+G7sSB0aGF5IMSR4buVaSDhu58gdGjDoG5oIHBo4bqnbiBuw6B5IMSRw7JpIGjhu49pIHRow6BuaCBwaOG6p24ga2lhIGPFqW5nIHBo4bqjaSB0aGF5IMSR4buVaSDEkeG7gyBkdXkgdHLDrCB0w61uaCDEkcO6bmcgxJHhuq9uIGPhu6dhIHRvw6BuIGjhu4cgdGjhu5FuZyIqLg0KDQojIyMjIDEuIFN0YXRpYyBDb25uYXNjZW5jZSAoTmjhuq1uIGJp4bq/dCBsw7pjIGJpw6puIGThu4tjaCAvIENvbXBpbGUtdGltZSkNCi0gKipDb25uYXNjZW5jZSBvZiBOYW1lIChDb04pKio6IEhhaSBiw6puIHBo4bqjaSB0aOG7kW5nIG5o4bqldCB0w6puIGjDoG0vYmnhur9uIChD4bqlcCDEkeG7mSBuaOG6uSBuaOG6pXQsIGPDtG5nIGPhu6UgUmVmYWN0b3IgdOG7sSDEkeG7lWkgxJHGsOG7o2MpLg0KLSAqKkNvbm5hc2NlbmNlIG9mIFR5cGUgKENvVCkqKjogSGFpIGLDqm4gcGjhuqNpIHRo4buRbmcgbmjhuqV0IGtp4buDdSBk4buvIGxp4buHdSAodsOtIGThu6UgdHJ1eeG7gW4gYGludGAgaGF5IGBzdHJpbmdgKS4NCi0gKipDb25uYXNjZW5jZSBvZiBNZWFuaW5nIChDb00pKio6IEhhaSBiw6puIGPDuW5nIGhp4buDdSBuZ+G6p20gw70gbmdoxKlhIG3hu5l0IGdpw6EgdHLhu4sgxJHhurdjIGJp4buHdCAoVsOtIGThu6U6IGBzdGF0dXMgPSAxYCBsw6AgQWN0aXZlLCBgc3RhdHVzID0gLTk5YCBsw6AgxJDDoyB4w7NhICRcaW1wbGllcyQgTWFnaWMgTnVtYmVycyBuZ3V5IGhp4buDbSkuDQotICoqQ29ubmFzY2VuY2Ugb2YgUG9zaXRpb24gKENvUCkqKjogVGjhu6kgdOG7sSB0aGFtIHPhu5EgdHJ1eeG7gW4gdsOgbyBow6BtOiBgY3JlYXRlVXNlcihuYW1lLCBlbWFpbCwgYWdlLCBhZGRyZXNzKWAgJFxpbXBsaWVzJCBO4bq/dSDEkeG7lWkgduG7iyB0csOtIHRoYW0gc+G7kSBz4bq9IGfDonkgbOG7l2kgw6JtIHRo4bqnbS4NCi0gKipDb25uYXNjZW5jZSBvZiBBbGdvcml0aG0gKENvQSkqKjogSGFpIGLDqm4gcGjhuqNpIGTDuW5nIGNodW5nIG3hu5l0IHRodeG6rXQgdG/DoW4gbcOjIGjDs2EgaG/hurdjIGNoZWNrc3VtIChNRDUsIFNIQS0yNTYpIHRow6wgbeG7m2kgZ2nhuqNpIG3DoyDEkcaw4bujYy4NCg0KIyMjIyAyLiBEeW5hbWljIENvbm5hc2NlbmNlIChDaOG7iSBuaOG6rW4gYmnhur90IGzDumMgY2jhuqF5IC8gUnVudGltZSAtIFLhuqV0IG5ndXkgaGnhu4NtKQ0KLSAqKkNvbm5hc2NlbmNlIG9mIEV4ZWN1dGlvbiAoQ29FKSoqOiBIw6BtIEEgKipi4bqvdCBideG7mWMgcGjhuqNpIMSRxrDhu6NjIGfhu41pIHRyxrDhu5tjKiogaMOgbSBCIChWw60gZOG7pTogcGjhuqNpIGfhu41pIGBpbml0KClgIHRyxrDhu5tjIGtoaSBn4buNaSBgY29ubmVjdCgpYCkuDQotICoqQ29ubmFzY2VuY2Ugb2YgVGltaW5nIChDb1QpKio6IEhhaSB0aeG6v24gdHLDrG5oIHBo4bqjaSBjaOG6oXkgdHJvbmcgbeG7mXQga2hv4bqjbmcgdGjhu51pIGdpYW4gbmjhuqV0IMSR4buLbmggbeG7m2kga2jDtG5nIGLhu4sgZMOtbmggUmFjZSBDb25kaXRpb24uDQotICoqQ29ubmFzY2VuY2Ugb2YgVmFsdWVzIChDb1YpKio6IEdpw6EgdHLhu4sgY+G7p2EgYmnhur9uIOG7nyBub2RlIEEgcGjhuqNpIHTGsMahbmcgdGjDrWNoIHbhu5tpIGdpw6EgdHLhu4sg4bufIG5vZGUgQiAoVsOtIGThu6U6IEPhuqV1IGjDrG5oIHBow6JuIHTDoW4gZ2nhu69hIDIgbWljcm9zZXJ2aWNlcykuDQoNCi0tLQ0KDQojIyMgMi4zLiBQaMOibiBD4bqlcCBDw6FjIEPhuqVwIMSQ4buZIEfhuq9uIEvhur90IChDb2hlc2lvbiBTcGVjdHJ1bTogVOG7qyBU4buTaSBU4buHIE5o4bqldCDEkOG6v24gVOG7kXQgTmjhuqV0KQ0KDQrEkOG7mSBn4bqvbiBr4bq/dCAoQ29oZXNpb24pIMSRbyBsxrDhu51uZyBt4bupYyDEkeG7mSBjw6FjIHBo4bqnbiB04butIGLDqm4gdHJvbmcgbeG7mXQgbW9kdWxlIHRodeG7mWMgduG7gSBuaGF1IHbDoCBjw7luZyBwaOG7pWMgduG7pSBt4buZdCBt4bulYyDEkcOtY2ggZHV5IG5o4bqldDoNCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgQzFbIjEuIENvaW5jaWRlbnRhbCAoTmfhuqt1IE5oacOqbjogSGVscGVyLCBVdGlscyBnb20gYuG7q2EgYsOjaSkiXSAtLT4gQzJbIjIuIExvZ2ljYWwgKExvZ2ljOiBHb20gY8OhYyBow6BtIGPDuW5nIGtp4buDdSBuaMawIEV4cG9ydCBBbGwgdG8gUERGL0NTVikiXQ0KICAgIEMyIC0tPiBDM1siMy4gVGVtcG9yYWwgKFRo4budaSBHaWFuOiBLaOG7n2kgdOG6oW8gY8O5bmcgdGjhu51pIMSRaeG7g20gU3RhcnR1cCkiXQ0KICAgIEMzIC0tPiBDNFsiNC4gUHJvY2VkdXJhbCAoVGjhu6cgVOG7pWM6IENo4bqheSB0aGVvIGPDoWMgYsaw4bubYyB0deG6p24gdOG7sSAxLCAyLCAzKSJdDQogICAgQzQgLS0+IEM1WyI1LiBDb21tdW5pY2F0aW9uYWwgKFRydXnhu4FuIFRow7RuZzogVGhhbyB0w6FjIHRyw6puIGPDuW5nIG3hu5l0IHThuq1wIERhdGEpIl0NCiAgICBDNSAtLT4gQzZbIjYuIFNlcXVlbnRpYWwgKFR14bqnbiBU4buxOiBPdXRwdXQgY+G7p2EgYsaw4bubYyBuw6B5IGzDoCBJbnB1dCBixrDhu5tjIHNhdSkiXQ0KICAgIEM2IC0tPiBDN1siNy4gRnVuY3Rpb25hbCBDb2hlc2lvbiAoQ0jhu6hDIE7Egk5HOiBDaOG7iSBsw6BtIMSRw7puZyAxIG5oaeG7h20gduG7pSBkdXkgbmjhuqV0IC0gxJDhu4hOSCBDQU8hKSJdDQoNCiAgICBjbGFzc0RlZiBiYWQgZmlsbDojZmVlMmUyLHN0cm9rZTojZWY0NDQ0Ow0KICAgIGNsYXNzRGVmIGdvb2QgZmlsbDojZGNmY2U3LHN0cm9rZTojMTZhMzRhOw0KICAgIGNsYXNzIEMxLEMyLEMzIGJhZDsNCiAgICBjbGFzcyBDNixDNyBnb29kOw0KYGBgDQoNCi0gKipDb2luY2lkZW50YWwgQ29oZXNpb24gKFRo4bqjbSBo4buNYSBs4bubcCBgQ29tbW9uVXRpbHMgLyBHZW5lcmFsSGVscGVyYCkqKjogTeG7mXQgY2xhc3MgcsOhYyBjaOG7qWEgY+G6oyBow6BtIHTDrW5oIGPEg24gYuG6rWMgaGFpLCBow6BtIGZvcm1hdCBuZ8OgeSB0aMOhbmcsIHbDoCBow6BtIGfhu61pIGVtYWlsISBDw6FjIGjDoG0gbsOgeSBob8OgbiB0b8OgbiBraMO0bmcgY8OzIGLhuqV0IGvhu7MgbeG7kWkgbGnDqm4gaOG7hyBsb2dpYyBuw6BvIHbhu5tpIG5oYXUuDQotICoqRnVuY3Rpb25hbCBDb2hlc2lvbiAoxJDhu4luaCBjYW8gY+G7p2EgU1JQKSoqOiBN4buNaSBkw7JuZyBjb2RlIGLDqm4gdHJvbmcgbW9kdWxlIMSR4buBdSBwaOG7pWMgduG7pSBjaG8gbeG7mXQgY2jhu6ljIG7Eg25nIGPhu5F0IGzDtWkgZHV5IG5o4bqldCAoVsOtIGThu6U6IGBYbWxQYXlsb2FkUGFyc2VyYCBjaOG7iSBsw6BtIMSRw7puZyB2aeG7h2MgcGjDom4gdMOtY2ggY8O6IHBow6FwIFhNTCwgYEJjcnlwdFBhc3N3b3JkSGFzaGVyYCBjaOG7iSBsw6BtIMSRw7puZyB2aeG7h2MgYsSDbSBt4bqtdCBraOG6qXUpLg0KDQotLS0NCg0KIyMjIDIuNC4gUGFja2FnZSBDb3VwbGluZyBQcmluY2lwbGVzOiBTRFAgJiBTQVAgKFJvYmVydCBDLiBNYXJ0aW4gLSBVbmNsZSBCb2IpDQoNCktoaSBj4bqldSB0csO6YyBjw6FjIFBhY2thZ2UgLyBUaMawIG3hu6VjIHRyb25nIGThu7Egw6FuIEJhY2tlbmQgbOG7m24sIFVuY2xlIEJvYiDEkeG7i25oIG5naMSpYSBoYWkgbmd1ecOqbiBsw70gdG/DoW4gaOG7jWMgxJHhu4MgZ2nhu68gaOG7hyB0aOG7kW5nIGtow7RuZyBi4buLIG3hu6VjIHLhu5duZzoNCg0KYGBgbWVybWFpZA0KcXVhZHJhbnRDaGFydA0KICAgIHRpdGxlIEJp4buDdSDEkOG7kyBDaHXhu5dpIENow61uaCAoVGhlIE1haW4gU2VxdWVuY2U6IEFic3RyYWN0bmVzcyB2cyBJbnN0YWJpbGl0eSkNCiAgICB4LWF4aXMgIuG7lG4gxJDhu4tuaCBUdXnhu4d0IMSQ4buRaSAoSSA9IDApIiAtLT4gIkLhuqV0IOG7lG4gxJDhu4tuaCBUdXnhu4d0IMSQ4buRaSAoSSA9IDEpIg0KICAgIHktYXhpcyAiQ+G7pSBUaOG7gyBUdXnhu4d0IMSQ4buRaSAoQSA9IDApIiAtLT4gIlRy4burdSBUxrDhu6NuZyBUdXnhu4d0IMSQ4buRaSAoQSA9IDEpIg0KICAgIHF1YWRyYW50LTEgIlbDuW5nIFbDtCBE4bulbmcgKFpvbmUgb2YgVXNlbGVzc25lc3M6IFF1w6EgdHLhu6t1IHTGsOG7o25nIG3DoCBraMO0bmcgYWkgZMO5bmcpIg0KICAgIHF1YWRyYW50LTIgIlRoZSBNYWluIFNlcXVlbmNlICjEkMaw4budbmcgQ8OibiBC4bqxbmcgQ2h14bqpbiBN4buxYykiDQogICAgcXVhZHJhbnQtMyAiVsO5bmcgxJBhdSBLaOG7lSAoWm9uZSBvZiBQYWluOiBD4bupbmcgbmjhuq9jLCBD4buxYyBraMOzIHPhu61hIMSR4buVaSkiDQogICAgcXVhZHJhbnQtNCAiVGhlIE1haW4gU2VxdWVuY2UgKMSQxrDhu51uZyBDw6JuIELhurFuZyBDaHXhuqluIE3hu7FjKSINCiAgICAiQ8ahIHPhu58gZOG7ryBsaeG7h3UgbMO1aSI6IFswLjEwLCAwLjEwXQ0KICAgICJQbHVnaW4gZ2lhbyBkaeG7h24gV2ViIjogWzAuOTAsIDAuODVdDQogICAgIkludGVyZmFjZSBjaHXhuqluIG3hu7FjIjogWzAuMzUsIDAuNjVdDQpgYGANCg0KIyMjIyAxLiBTdGFibGUgRGVwZW5kZW5jaWVzIFByaW5jaXBsZSAoU0RQIC0gTmd1ecOqbiBMw70gUGjhu6UgVGh14buZYyDhu5RuIMSQ4buLbmgpDQotICoqxJDhu4tuaCBsdeG6rXQqKjogKiJIxrDhu5tuZyBj4bunYSBjw6FjIG3hu5FpIHF1YW4gaOG7hyBwaOG7pSB0aHXhu5ljIHBo4bqjaSBsdcO0biBsdcO0biDEkWkgduG7gSBwaMOtYSBj4bunYSBz4buxIOG7lW4gxJHhu4tuaCIqLg0KLSAqKkNo4buJIHPhu5EgQuG6pXQg4buUbiDEkOG7i25oIChJbnN0YWJpbGl0eSBNZXRyaWMgJEkkKSoqOg0KICAkJEkgPSBcZnJhY3tDX2V9e0NfYSArIENfZX0kJA0KICAtICRDX2EkIChBZmZlcmVudCBDb3VwbGluZyAtIEtow6FjaCBow6BuZyk6IFPhu5EgbMaw4bujbmcgcGFja2FnZSBiw6puIG5nb8OgaSBwaOG7pSB0aHXhu5ljIHbDoG8gcGFja2FnZSBuw6B5Lg0KICAtICRDX2UkIChFZmZlcmVudCBDb3VwbGluZyAtIE5ow6AgY3VuZyBj4bqlcCk6IFPhu5EgbMaw4bujbmcgcGFja2FnZSBiw6puIG5nb8OgaSBtw6AgcGFja2FnZSBuw6B5IHBo4bqjaSBwaOG7pSB0aHXhu5ljIHbDoG8uDQogIC0gJEkgPSAwJDogKirhu5RuIMSR4buLbmggdHV54buHdCDEkeG7kWkqKiAoTmhp4buBdSBuZ8aw4budaSBwaOG7pSB0aHXhu5ljIHbDoG8gbsOzLCBuw7Mga2jDtG5nIHBo4bulIHRodeG7mWMgdsOgbyBhaSAkXGltcGxpZXMkIFLhuqV0IGtow7MgdGhheSDEkeG7lWkpLg0KICAtICRJID0gMSQ6ICoqQuG6pXQg4buVbiDEkeG7i25oIHThu5FpIMSRYSoqIChLaMO0bmcgYWkgcGjhu6UgdGh14buZYyB2w6BvIG7DsywgbsOzIHBo4bulIHRodeG7mWMgdsOgbyBuaGnhu4F1IG7GoWkgJFxpbXBsaWVzJCBS4bqldCBk4buFIHRoYXkgxJHhu5VpKS4NCg0KIyMjIyAyLiBTdGFibGUgQWJzdHJhY3Rpb25zIFByaW5jaXBsZSAoU0FQIC0gTmd1ecOqbiBMw70gVHLhu6t1IFTGsOG7o25nIOG7lG4gxJDhu4tuaCkNCi0gKirEkOG7i25oIGx14bqtdCoqOiAqIk3hu5l0IHBhY2thZ2UgY8Ogbmcg4buVbiDEkeG7i25oICgkSSBcdG8gMCQpIHRow6wgbsOzIGPDoG5nIGLhuq90IGJ14buZYyBwaOG6o2kgdHLhu6t1IHTGsOG7o25nICgkQSBcdG8gMSQpIiouDQotICoqQ2jhu4kgc+G7kSBUcuG7q3UgVMaw4bujbmcgKEFic3RyYWN0bmVzcyBNZXRyaWMgJEEkKSoqOg0KICAkJEEgPSBcZnJhY3tOX2F9e05fY30kJA0KICAtICROX2EkOiBT4buRIGzGsOG7o25nIEludGVyZmFjZSB2w6AgQWJzdHJhY3QgQ2xhc3MgdHJvbmcgcGFja2FnZS4NCiAgLSAkTl9jJDogVOG7lW5nIHPhu5EgbMaw4bujbmcgQ2xhc3MgdHJvbmcgcGFja2FnZS4NCi0gKipLaG/huqNuZyBjw6FjaCDEkeG6v24gQ2h14buXaSBDaMOtbmggKERpc3RhbmNlIGZyb20gdGhlIE1haW4gU2VxdWVuY2UgJEQkKSoqOg0KICAkJEQgPSB8QSArIEkgLSAxfCQkDQogIC0gTeG7mXQgcGFja2FnZSBsw70gdMaw4bufbmcgcGjhuqNpIG7hurFtIHPDoXQgxJHGsOG7nW5nICRBICsgSSA9IDEgXGltcGxpZXMgRCBcYXBwcm94IDAkLg0KICAtIE7hur91ICREIFx0byAxJCDhu58gZ8OzYyBkxrDhu5tpICgkQSA9IDAsIEkgPSAwJCk6IFBhY2thZ2UgcsahaSB2w6BvICoqIlbDuW5nIMSQYXUgS2jhu5UiIChab25lIG9mIFBhaW4pKio6IFF1w6Egbmhp4buBdSBuxqFpIHBo4bulIHRodeG7mWMgdsOgbyBuw7MgbmjGsG5nIG7DsyBs4bqhaSB2aeG6v3QgYuG6sW5nIGPDoWMgY2xhc3MgY+G7pSB0aOG7gyBj4bupbmcgbmjhuq9jLCBraGnhur9uIG3hu5dpIGzhuqduIHPhu61hIMSR4buVaSBsw6AgbeG7mXQgY8ahbiDDoWMgbeG7mW5nIQ0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIFJlZmFjdG9yaW5nIENvbnRyb2wgQ291cGxpbmcgdGjDoG5oIFBvbHltb3JwaGljIFN0cmF0ZWd5DQoNCkNoxrDGoW5nIHRyw6xuaCBtaW5oIGNo4bupbmcgY8OhY2ggbG/huqFpIGLhu48gbcOjIGjDtGkgKipDb250cm9sIENvdXBsaW5nKiogKFRydXnhu4FuIGPhu50gYm9vbGVhbiDEkWnhu4F1IGtoaeG7g24gaWYtZWxzZSBiw6puIHRyb25nIGjDoG0ga2jDoWMpIHbDoCB0w6FpIGPhuqV1IHRyw7pjIHRow6BuaCB0aGnhur90IGvhur8gZ2jDqXAgbuG7kWkgbOG7j25nIGzhurtvIGLhurFuZyBDKysyMCBMYW1iZGFzIHbDoCBQb2x5bW9ycGhpc206DQoNCmBgYGNwcA0KLy8gY29udHJvbF9jb3VwbGluZ19yZWZhY3RvcmluZy5jcHANCi8vIEJpw6puIGThu4tjaDogZysrIC1zdGQ9YysrMjAgLU8zIGNvbnRyb2xfY291cGxpbmdfcmVmYWN0b3JpbmcuY3BwIC1vIGNvbnRyb2xfY291cGxpbmdfcmVmYWN0b3JpbmcNCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dmVjdG9yPg0KI2luY2x1ZGUgPG1lbW9yeT4NCiNpbmNsdWRlIDxmdW5jdGlvbmFsPg0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBQSOG6ok4gTeG6qlUgVEhJ4bq+VCBL4bq+OiBDT05UUk9MIENPVVBMSU5HIChUcnV54buBbiBj4budIGJvb2xlYW4gw6lwIGjDoG0gcGjDom4gbmjDoW5oKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgQmFkSW52b2ljZVNlcnZpY2Ugew0KcHVibGljOg0KICAgIHZvaWQgcHJpbnRfaW52b2ljZShkb3VibGUgYW1vdW50LCBib29sIGlzX3ZpcF9jdXN0b21lciwgYm9vbCBzZW5kX2VtYWlsKSB7DQogICAgICAgIC8vIEjDoG0gYuG7iyBDb250cm9sIENvdXBsaW5nOiBCw6puIG5nb8OgaSDEkWnhu4F1IGtoaeG7g24gbHXhu5NuZyBu4buZaSBi4buZIGPhu6dhIGjDoG0NCiAgICAgICAgZG91YmxlIGZpbmFsX3ByaWNlID0gYW1vdW50Ow0KICAgICAgICBpZiAoaXNfdmlwX2N1c3RvbWVyKSB7DQogICAgICAgICAgICBmaW5hbF9wcmljZSAqPSAwLjg1OyAvLyBHaeG6o20gZ2nDoSBWSVAgMTUlDQogICAgICAgIH0NCg0KICAgICAgICBzdGQ6OmNvdXQgPDwgIltCQUQgSU5WT0lDRV0gSMOzYSDEkcahbjogJCIgPDwgZmluYWxfcHJpY2UgPDwgIlxuIjsNCg0KICAgICAgICBpZiAoc2VuZF9lbWFpbCkgew0KICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IMOCbSB0aOG6p20ga8OtY2ggaG/huqF0IGfhu61pIGVtYWlsIGjDs2EgxJHGoW4gbuG7mWkgYuG7mS4uLlxuIjsNCiAgICAgICAgfQ0KICAgIH0NCn07DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIFRISeG6vlQgS+G6viBDSFXhuqhOIE3hu7BDOiBEQVRBIENPVVBMSU5HICYgU1RSQVRFR1kgKExv4bqhaSBi4buPIGhvw6BuIHRvw6BuIENvbnRyb2wgRmxhZykNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCnN0cnVjdCBEaXNjb3VudFBvbGljeSB7DQogICAgc3RkOjpmdW5jdGlvbjxkb3VibGUoZG91YmxlKT4gYXBwbHlfZGlzY291bnQ7DQp9Ow0KDQpjbGFzcyBDbGVhbkludm9pY2VTZXJ2aWNlIHsNCnB1YmxpYzoNCiAgICAvLyBDaOG7iSBuaOG6rW4gZOG7ryBsaeG7h3UgdGh14bqnbiB0w7p5IChEYXRhIENvdXBsaW5nKSB2w6AgU3RyYXRlZ3kgxJHDoyDEkcaw4bujYyBj4bqldSBow6xuaCB0csaw4bubYw0KICAgIGRvdWJsZSBjYWxjdWxhdGVfZmluYWxfYW1vdW50KGRvdWJsZSByYXdfYW1vdW50LCBjb25zdCBEaXNjb3VudFBvbGljeSYgcG9saWN5KSB7DQogICAgICAgIHJldHVybiBwb2xpY3kuYXBwbHlfZGlzY291bnQocmF3X2Ftb3VudCk7DQogICAgfQ0KfTsNCg0KaW50IG1haW4oKSB7DQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuIjsNCiAgICBzdGQ6OmNvdXQgPDwgIiAgICAgICBSRUZBQ1RPUklORyBDT05UUk9MIENPVVBMSU5HIFNBTkcgREFUQSAvIFNUUkFURUdZIENPVVBMSU5HICAgICAgXG4iOw0KICAgIHN0ZDo6Y291dCA8PCAiPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuIjsNCg0KICAgIC8vIDEuIENo4bqheSB0aOG7rSBuZ2hp4buHbSBQaOG6o24gbeG6q3UgQ29udHJvbCBDb3VwbGluZw0KICAgIHN0ZDo6Y291dCA8PCAiLS0tIDEuIENI4bqgWSBUSOG7rCBNw4MgSMOUSSBDT05UUk9MIENPVVBMSU5HIC0tLVxuIjsNCiAgICBCYWRJbnZvaWNlU2VydmljZSBiYWRfc3ZjOw0KICAgIGJhZF9zdmMucHJpbnRfaW52b2ljZSgxMDAuMCwgdHJ1ZSwgdHJ1ZSk7IC8vIEPDoWMgY+G7nSBib29sZWFuIG3GoSBo4buTOiB0cnVlLCB0cnVlIGzDoCBnw6w/DQoNCiAgICAvLyAyLiBDaOG6oXkgdGjhu60gbmdoaeG7h20gVGhp4bq/dCBr4bq/IFPhuqFjaCAoU3RyYXRlZ3kgSW5qZWN0aW9uKQ0KICAgIHN0ZDo6Y291dCA8PCAiXG4tLS0gMi4gQ0jhuqBZIFRI4busIFRISeG6vlQgS+G6viBT4bqgQ0ggKERBVEEgQ09VUExJTkcpIC0tLVxuIjsNCiAgICBDbGVhbkludm9pY2VTZXJ2aWNlIGNsZWFuX3N2YzsNCg0KICAgIERpc2NvdW50UG9saWN5IHZpcF9kaXNjb3VudHsgW10oZG91YmxlIGEpIHsgcmV0dXJuIGEgKiAwLjg1OyB9IH07DQogICAgRGlzY291bnRQb2xpY3kgcmVndWxhcl9kaXNjb3VudHsgW10oZG91YmxlIGEpIHsgcmV0dXJuIGEgKiAxLjA7IH0gfTsNCg0KICAgIGRvdWJsZSB2aXBfZmluYWwgPSBjbGVhbl9zdmMuY2FsY3VsYXRlX2ZpbmFsX2Ftb3VudCgxMDAuMCwgdmlwX2Rpc2NvdW50KTsNCiAgICBkb3VibGUgcmVndWxhcl9maW5hbCA9IGNsZWFuX3N2Yy5jYWxjdWxhdGVfZmluYWxfYW1vdW50KDEwMC4wLCByZWd1bGFyX2Rpc2NvdW50KTsNCg0KICAgIHN0ZDo6Y291dCA8PCAiW0NMRUFOIElOVk9JQ0VdIEjDs2EgxJHGoW4gVklQICAgICAgICAgOiAkIiA8PCB2aXBfZmluYWwgPDwgIlxuIjsNCiAgICBzdGQ6OmNvdXQgPDwgIltDTEVBTiBJTlZPSUNFXSBIw7NhIMSRxqFuIFRoxrDhu51uZyAgICAgIDogJCIgPDwgcmVndWxhcl9maW5hbCA8PCAiXG4iOw0KDQogICAgc3RkOjpjb3V0IDw8ICJcbj4+PiBL4bq+VCBRVeG6ojogVMOhY2ggcuG7nWkgdmnhu4djIHTDrW5oIHRp4buBbiB2w6AgZ+G7rWkgZW1haWwgdGjDoG5oIDIgdHLDoWNoIG5oaeG7h20gcmnDqm5nLFxuIg0KICAgICAgICAgICAgICA8PCAiICAgIGxv4bqhaSBi4buPIGhvw6BuIHRvw6BuIGPhu50gYm9vbGVhbiDEkWnhu4F1IGtoaeG7g24gbuG7mWkgYuG7mSFcbiI7DQoNCiAgICByZXR1cm4gMDsNCn0NCmBgYA0KDQojIyMjIFRlcm1pbmFsIE91dHB1dCBN4bqrdToNCmBgYHRleHQNCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQogICAgICAgUkVGQUNUT1JJTkcgQ09OVFJPTCBDT1VQTElORyBTQU5HIERBVEEgLyBTVFJBVEVHWSBDT1VQTElORyAgICAgIA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCg0KLS0tIDEuIENI4bqgWSBUSOG7rCBNw4MgSMOUSSBDT05UUk9MIENPVVBMSU5HIC0tLQ0KW0JBRCBJTlZPSUNFXSBIw7NhIMSRxqFuOiAkODUNCiAgLT4gw4JtIHRo4bqnbSBrw61jaCBob+G6oXQgZ+G7rWkgZW1haWwgaMOzYSDEkcahbiBu4buZaSBi4buZLi4uDQoNCi0tLSAyLiBDSOG6oFkgVEjhu6wgVEhJ4bq+VCBL4bq+IFPhuqBDSCAoREFUQSBDT1VQTElORykgLS0tDQpbQ0xFQU4gSU5WT0lDRV0gSMOzYSDEkcahbiBWSVAgICAgICAgICA6ICQ4NQ0KW0NMRUFOIElOVk9JQ0VdIEjDs2EgxJHGoW4gVGjGsOG7nW5nICAgICAgOiAkMTAwDQoNCj4+PiBL4bq+VCBRVeG6ojogVMOhY2ggcuG7nWkgdmnhu4djIHTDrW5oIHRp4buBbiB2w6AgZ+G7rWkgZW1haWwgdGjDoG5oIDIgdHLDoWNoIG5oaeG7h20gcmnDqm5nLA0KICAgIGxv4bqhaSBi4buPIGhvw6BuIHRvw6BuIGPhu50gYm9vbGVhbiDEkWnhu4F1IGtoaeG7g24gbuG7mWkgYuG7mSENCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gUHl0aG9uIDMuMTErIFBhY2thZ2UgTWV0cmljcyBDYWxjdWxhdG9yOiBJbnN0YWJpbGl0eSAoJEkkKSwgQWJzdHJhY3RuZXNzICgkQSQpICYgRGlzdGFuY2UgKCREJCkNCg0KQ2jGsMahbmcgdHLDrG5oIG1pbmggY2jhu6luZyBjw6FjaCB0w61uaCB0b8OhbiB0b8OhbiBo4buNYyBjw6FjIGNo4buJIHPhu5Ega2nhur9uIHRyw7pjIGPhu6dhIFJvYmVydCBDLiBNYXJ0aW46IMSQbyBsxrDhu51uZyDEkeG7mSBi4bqldCDhu5VuIMSR4buLbmggJEkkLCDEkeG7mSB0cuG7q3UgdMaw4bujbmcgJEEkLCB2w6Aga2hv4bqjbmcgY8OhY2ggdOG7m2kgQ2h14buXaSBDaMOtbmggJEQkLCB04buxIMSR4buZbmcgcGjDoXQgaGnhu4duIGPDoWMgcGFja2FnZSByxqFpIHbDoG8gKioiVsO5bmcgxJBhdSBLaOG7lSIgKFpvbmUgb2YgUGFpbikqKjoNCg0KYGBgcHl0aG9uDQojIS91c3IvYmluL2VudiBweXRob24zDQoiIiINCnBhY2thZ2VfbWV0cmljc19hbmFseXplci5weQ0KQ8O0bmcgQ+G7pSBUw61uaCBUb8OhbiBUb8OhbiBI4buNYyBDw6FjIENo4buJIFPhu5EgUGFja2FnZSBDb3VwbGluZzogU0RQLCBTQVAgdsOgIFRoZSBNYWluIFNlcXVlbmNlDQoiIiINCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcw0KZnJvbSB0eXBpbmcgaW1wb3J0IExpc3QNCg0KQGRhdGFjbGFzcw0KY2xhc3MgUGFja2FnZU1ldHJpY3M6DQogICAgbmFtZTogc3RyDQogICAgY2E6IGludCAgICAgICAgICAgICMgQWZmZXJlbnQgQ291cGxpbmc6IFPhu5EgcGFja2FnZSBiw6puIG5nb8OgaSBwaOG7pSB0aHXhu5ljIHbDoG8gcGFja2FnZSBuw6B5DQogICAgY2U6IGludCAgICAgICAgICAgICMgRWZmZXJlbnQgQ291cGxpbmc6IFPhu5EgcGFja2FnZSBiw6puIG5nb8OgaSBtw6AgcGFja2FnZSBuw6B5IHBo4bulIHRodeG7mWMgdsOgbw0KICAgIG51bV9jbGFzc2VzOiBpbnQgICAjIFThu5VuZyBz4buRIGNsYXNzIGPhu6UgdGjhu4MgKE5jKQ0KICAgIG51bV9hYnN0cmFjdDogaW50ICAjIFPhu5EgbMaw4bujbmcgaW50ZXJmYWNlcyAvIGFic3RyYWN0IGNsYXNzZXMgKE5hKQ0KDQogICAgQHByb3BlcnR5DQogICAgZGVmIGluc3RhYmlsaXR5KHNlbGYpIC0+IGZsb2F0Og0KICAgICAgICAiIiJJID0gQ2UgLyAoQ2EgKyBDZSkiIiINCiAgICAgICAgdG90YWwgPSBzZWxmLmNhICsgc2VsZi5jZQ0KICAgICAgICByZXR1cm4gKHNlbGYuY2UgLyB0b3RhbCkgaWYgdG90YWwgPiAwIGVsc2UgMC4wDQoNCiAgICBAcHJvcGVydHkNCiAgICBkZWYgYWJzdHJhY3RuZXNzKHNlbGYpIC0+IGZsb2F0Og0KICAgICAgICAiIiJBID0gTmEgLyBOYyIiIg0KICAgICAgICByZXR1cm4gKHNlbGYubnVtX2Fic3RyYWN0IC8gc2VsZi5udW1fY2xhc3NlcykgaWYgc2VsZi5udW1fY2xhc3NlcyA+IDAgZWxzZSAwLjANCg0KICAgIEBwcm9wZXJ0eQ0KICAgIGRlZiBkaXN0YW5jZV9mcm9tX21haW5fc2VxdWVuY2Uoc2VsZikgLT4gZmxvYXQ6DQogICAgICAgICIiIkQgPSB8QSArIEkgLSAxfCIiIg0KICAgICAgICByZXR1cm4gYWJzKHNlbGYuYWJzdHJhY3RuZXNzICsgc2VsZi5pbnN0YWJpbGl0eSAtIDEuMCkNCg0KICAgIGRlZiBkaWFnbm9zZV96b25lKHNlbGYpIC0+IHN0cjoNCiAgICAgICAgZCA9IHNlbGYuZGlzdGFuY2VfZnJvbV9tYWluX3NlcXVlbmNlDQogICAgICAgIGlmIGQgPCAwLjI6DQogICAgICAgICAgICByZXR1cm4gIlRIRSBNQUlOIFNFUVVFTkNFIChDw6JuIELhurFuZyBIb8OgbiBI4bqjbykiDQogICAgICAgIGVsaWYgc2VsZi5hYnN0cmFjdG5lc3MgPCAwLjMgYW5kIHNlbGYuaW5zdGFiaWxpdHkgPCAwLjM6DQogICAgICAgICAgICByZXR1cm4gIiEhISBWw5lORyDEkEFVIEtI4buUIChaT05FIE9GIFBBSU46IFF1w6EgY+G7pSB0aOG7gyBuaMawbmcgcXXDoSBuaGnhu4F1IG5nxrDhu51pIHBo4bulIHRodeG7mWMhKSAhISEiDQogICAgICAgIGVsaWYgc2VsZi5hYnN0cmFjdG5lc3MgPiAwLjcgYW5kIHNlbGYuaW5zdGFiaWxpdHkgPiAwLjc6DQogICAgICAgICAgICByZXR1cm4gIlbDmU5HIFbDlCBE4bukTkcgKFpPTkUgT0YgVVNFTEVTU05FU1M6IFF1w6EgdHLhu6t1IHTGsOG7o25nIG5oxrBuZyBraMO0bmcgYWkgZMO5bmcpIg0KICAgICAgICByZXR1cm4gIkNI4bqkUCBOSOG6rE4gxJDGr+G7okMiDQoNCmRlZiBtYWluKCk6DQogICAgcHJpbnQoIj0iICogODApDQogICAgcHJpbnQoIiAgICAgQ8OUTkcgQ+G7pCBQSMOCTiBUw41DSCBUT8OBTiBI4buMQyBDSOG7iCBT4buQIFBBQ0tBR0UgQ09VUExJTkcgKFNEUCAmIFNBUCkgICAgICAgICAgICAiKQ0KICAgIHByaW50KCI9IiAqIDgwKQ0KDQogICAgcGFja2FnZXMgPSBbDQogICAgICAgICMgR8OzaSBsw7VpIGPGoSBz4bufIGThu68gbGnhu4d1OiBOaGnhu4F1IG5nxrDhu51pIGTDuW5nIChDYT0yMCksIGtow7RuZyBwaOG7pSB0aHXhu5ljIGFpIChDZT0wKSwgbmjGsG5nIHRvw6BuIGNsYXNzIGPhu6UgdGjhu4MgKE5hPTApDQogICAgICAgIFBhY2thZ2VNZXRyaWNzKCJjb20uYXBwLmNvcmUuZGF0YWJhc2UiLCBjYT0yMCwgY2U9MCwgbnVtX2NsYXNzZXM9MTUsIG51bV9hYnN0cmFjdD0wKSwNCiAgICAgICAgIyBHw7NpIGdpYW8gZGnhu4duIHRy4burdSB0xrDhu6NuZyBjaHXhuqluIG3hu7FjOiBDYT0xNSwgQ2U9Miwgbmhp4buBdSBpbnRlcmZhY2UgKE5hPTgpDQogICAgICAgIFBhY2thZ2VNZXRyaWNzKCJjb20uYXBwLmRvbWFpbi5pbnRlcmZhY2VzIiwgY2E9MTUsIGNlPTIsIG51bV9jbGFzc2VzPTEwLCBudW1fYWJzdHJhY3Q9OCksDQogICAgICAgICMgR8OzaSBXZWIgQ29udHJvbGxlcnMg4bufIG5nb+G6oWkgdmk6IEtow7RuZyBhaSBkw7luZyAoQ2E9MCksIHBo4bulIHRodeG7mWMgbmhp4buBdSBuxqFpIChDZT0xMikNCiAgICAgICAgUGFja2FnZU1ldHJpY3MoImNvbS5hcHAud2ViLmNvbnRyb2xsZXJzIiwgY2E9MCwgY2U9MTIsIG51bV9jbGFzc2VzPTEyLCBudW1fYWJzdHJhY3Q9MSksDQogICAgXQ0KDQogICAgZm9yIHBrZyBpbiBwYWNrYWdlczoNCiAgICAgICAgcHJpbnQoZiJcbltQSMOCTiBUw41DSCBQQUNLQUdFXToge3BrZy5uYW1lfSIpDQogICAgICAgIHByaW50KGYiICAtIFBo4bulIHRodeG7mWMgdsOgby9yYSA6IENhID0ge3BrZy5jYX0gfCBDZSA9IHtwa2cuY2V9IikNCiAgICAgICAgcHJpbnQoZiIgIC0gQuG6pXQg4buUbiDEkOG7i25oIChJKSAgOiB7cGtnLmluc3RhYmlsaXR5Oi4zZn0gKDA6IFLhuqV0IOG7lG4gxJDhu4tuaCwgMTogUuG6pXQgQuG6pXQg4buUbikiKQ0KICAgICAgICBwcmludChmIiAgLSBUcuG7q3UgVMaw4bujbmcgKEEpICAgOiB7cGtnLmFic3RyYWN0bmVzczouM2Z9IChU4bu3IGzhu4cgSW50ZXJmYWNlczoge3BrZy5udW1fYWJzdHJhY3R9L3twa2cubnVtX2NsYXNzZXN9KSIpDQogICAgICAgIHByaW50KGYiICAtIEtob+G6o25nIEPDoWNoIChEKSAgOiB7cGtnLmRpc3RhbmNlX2Zyb21fbWFpbl9zZXF1ZW5jZTouM2Z9IChDw6BuZyBn4bqnbiAwIGPDoG5nIGNodeG6qW4pIikNCiAgICAgICAgcHJpbnQoZiIgID4+PiBDSOG6qE4gxJBPw4FOICAgICAgOiB7cGtnLmRpYWdub3NlX3pvbmUoKX0iKQ0KDQogICAgcHJpbnQoIlxuIiArICI9IiAqIDgwKQ0KDQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIG1haW4oKQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1Og0KYGBgdGV4dA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiAgICAgQ8OUTkcgQ+G7pCBQSMOCTiBUw41DSCBUT8OBTiBI4buMQyBDSOG7iCBT4buQIFBBQ0tBR0UgQ09VUExJTkcgKFNEUCAmIFNBUCkgICAgICAgICAgICANCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCltQSMOCTiBUw41DSCBQQUNLQUdFXTogY29tLmFwcC5jb3JlLmRhdGFiYXNlDQogIC0gUGjhu6UgdGh14buZYyB2w6BvL3JhIDogQ2EgPSAyMCB8IENlID0gMA0KICAtIELhuqV0IOG7lG4gxJDhu4tuaCAoSSkgIDogMC4wMDAgKDA6IFLhuqV0IOG7lG4gxJDhu4tuaCwgMTogUuG6pXQgQuG6pXQg4buUbikNCiAgLSBUcuG7q3UgVMaw4bujbmcgKEEpICAgOiAwLjAwMCAoVOG7tyBs4buHIEludGVyZmFjZXM6IDAvMTUpDQogIC0gS2hv4bqjbmcgQ8OhY2ggKEQpICA6IDEuMDAwIChDw6BuZyBn4bqnbiAwIGPDoG5nIGNodeG6qW4pDQogID4+PiBDSOG6qE4gxJBPw4FOICAgICAgOiAhISEgVsOZTkcgxJBBVSBLSOG7lCAoWk9ORSBPRiBQQUlOOiBRdcOhIGPhu6UgdGjhu4MgbmjGsG5nIHF1w6Egbmhp4buBdSBuZ8aw4budaSBwaOG7pSB0aHXhu5ljISkgISEhDQoNCltQSMOCTiBUw41DSCBQQUNLQUdFXTogY29tLmFwcC5kb21haW4uaW50ZXJmYWNlcw0KICAtIFBo4bulIHRodeG7mWMgdsOgby9yYSA6IENhID0gMTUgfCBDZSA9IDINCiAgLSBC4bqldCDhu5RuIMSQ4buLbmggKEkpICA6IDAuMTE4ICgwOiBS4bqldCDhu5RuIMSQ4buLbmgsIDE6IFLhuqV0IELhuqV0IOG7lG4pDQogIC0gVHLhu6t1IFTGsOG7o25nIChBKSAgIDogMC44MDAgKFThu7cgbOG7hyBJbnRlcmZhY2VzOiA4LzEwKQ0KICAtIEtob+G6o25nIEPDoWNoIChEKSAgOiAwLjA4MiAoQ8OgbmcgZ+G6p24gMCBjw6BuZyBjaHXhuqluKQ0KICA+Pj4gQ0jhuqhOIMSQT8OBTiAgICAgIDogVEhFIE1BSU4gU0VRVUVOQ0UgKEPDom4gQuG6sW5nIEhvw6BuIEjhuqNvKQ0KDQpbUEjDgk4gVMONQ0ggUEFDS0FHRV06IGNvbS5hcHAud2ViLmNvbnRyb2xsZXJzDQogIC0gUGjhu6UgdGh14buZYyB2w6BvL3JhIDogQ2EgPSAwIHwgQ2UgPSAxMg0KICAtIELhuqV0IOG7lG4gxJDhu4tuaCAoSSkgIDogMS4wMDAgKDA6IFLhuqV0IOG7lG4gxJDhu4tuaCwgMTogUuG6pXQgQuG6pXQg4buUbikNCiAgLSBUcuG7q3UgVMaw4bujbmcgKEEpICAgOiAwLjA4MyAoVOG7tyBs4buHIEludGVyZmFjZXM6IDEvMTIpDQogIC0gS2hv4bqjbmcgQ8OhY2ggKEQpICA6IDAuMDgzIChDw6BuZyBn4bqnbiAwIGPDoG5nIGNodeG6qW4pDQogID4+PiBDSOG6qE4gxJBPw4FOICAgICAgOiBUSEUgTUFJTiBTRVFVRU5DRSAoQ8OibiBC4bqxbmcgSG/DoG4gSOG6o28pDQoNCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyA0LjEuIEPhuqFtIELhuqt5IFRo4buxYyBDaGnhur9uIFRoxrDhu51uZyBH4bq3cCAoUHJvZHVjdGlvbiBQaXRmYWxscykNCg0KIyMjIyAxLiBT4buxIEPhu5EgIlpvbmUgb2YgUGFpbiIgS2hp4bq/biBUb8OgbiDEkOG7mWkgS2jDtG5nIFRo4buDIFJlZmFjdG9yDQotICoqSGnhu4duIHTGsOG7o25nKio6IE3hu5l0IGNsYXNzIGBDb3JlRW50aXR5LmphdmFgIG7hurFtIOG7nyDEkcOheSBraeG6v24gdHLDumMgY8OzICRJID0gMCQgKFRvw6BuIGLhu5kgNTAgbWljcm9zZXJ2aWNlcyBwaOG7pSB0aHXhu5ljIHbDoG8gbsOzKSwgbmjGsG5nICRBID0gMCQgKE7DsyBsw6AgbeG7mXQgY2xhc3MgY+G7pSB0aOG7gyBjaOG7qWEgaMOgbmcgbmdow6xuIGTDsm5nIGNvZGUgbG9naWMgdGjDtCkuDQotICoqSOG6rXUgcXXhuqMqKjogS2hpIG3hu5l0IHnDqnUgY+G6p3UgbmdoaeG7h3AgduG7pSBt4bubaSDEkcOyaSBo4buPaSBz4butYSDEkeG7lWkgbeG7mXQgcGjGsMahbmcgdGjhu6ljIGPhu6dhIGBDb3JlRW50aXR5YCwgcuG7p2kgcm8gc+G6rXAgaOG7hyB0aOG7kW5nIGzhu5tuIMSR4bq/biBt4bupYyBraMO0bmcgbeG7mXQgbOG6rXAgdHLDrG5oIHZpw6puIG7DoG8gZMOhbSDEkeG7mW5nIHbDoG8sIGJp4bq/biBuw7MgdGjDoG5oIG3hu5l0ICJraOG7kWkgdSBkaSBjxINuIiBj4bunYSBk4buxIMOhbi4NCi0gKipHaeG6o2kgcGjDoXAqKjogVMOhY2ggYENvcmVFbnRpdHlgIHRow6BuaCBt4buZdCBJbnRlcmZhY2UgdHLhu6t1IHTGsOG7o25nICgkQSBcdG8gMSQpIHbDoCBz4butIGThu6VuZyBEZXBlbmRlbmN5IEludmVyc2lvbi4NCg0KIyMjIyAyLiBUaOG6o20gSOG7jWEgIkdvZCBDbGFzcyAvIEtpdGNoZW4gU2luayBVdGlsaXR5Ig0KLSAqKkhp4buHbiB0xrDhu6NuZyoqOiBDbGFzcyBgU3RyaW5nSGVscGVyYCBob+G6t2MgYFN5c3RlbU1hbmFnZXJgIHBow6xuaCB0byBsw6puIDEwLjAwMCBkw7JuZyBjb2RlIHbhu5tpIENvaGVzaW9uIG5n4bqrdSBuaGnDqm4gKENvaW5jaWRlbnRhbCBDb2hlc2lvbikuDQotICoqSOG6rXUgcXXhuqMqKjogQuG6pXQga+G7syBwdWxsIHJlcXVlc3QgbsOgbyBjxaluZyBjaOG6oW0gdsOgbyBmaWxlIG7DoHksIGfDonkgcmEgTWVyZ2UgQ29uZmxpY3QgbGnDqm4gdOG7pWMgdsOgIGzDoG0gdGjhu51pIGdpYW4gY2jhuqF5IFVuaXQgVGVzdCBrw6lvIGTDoGkgaMOgbmcgY2jhu6VjIHBow7p0Lg0KLSAqKkdp4bqjaSBwaMOhcCoqOiBDaGlhIG5o4buPIGNsYXNzIHRoZW8gY8OhYyBtaeG7gW4gdHLDoWNoIG5oaeG7h20gY+G7pSB0aOG7gzogYERhdGVGb3JtYXR0ZXJgLCBgVXJsU2FuaXRpemVyYCwgYFBhc3N3b3JkVmFsaWRhdG9yYC4NCg0KIyMjIyAzLiBC4bqreSAiQ29ubmFzY2VuY2Ugb2YgUG9zaXRpb24iIEtoaSBUaGFtIFPhu5EgSMOgbSBWxrDhu6N0IFF1w6EgNSBCaeG6v24NCi0gKipIaeG7h24gdMaw4bujbmcqKjogSMOgbSBgcHJvY2Vzc1BheW1lbnQodXNlcklkLCBtZXJjaGFudElkLCBhbW91bnQsIHRheCwgZmVlLCBjdXJyZW5jeSwgaXNSZWZ1bmQsIGRpc2NvdW50KWAgY8OzIDggdGhhbSBz4buRIGPDuW5nIGtp4buDdSBk4buvIGxp4buHdS4NCi0gKipI4bqtdSBxdeG6oyoqOiBM4bqtcCB0csOsbmggdmnDqm4gdsO0IHTDrG5oIMSR4bqjbyBuaOG6p20gduG7iyB0csOtIGdp4buvYSBgYW1vdW50YCB2w6AgYHRheGAsIGfDonkgcmEgbOG7l2kgdMOtbmggdGnhu4FuIHNhaSBs4buHY2ggaMOgbmcgdGjDoW5nIHRy4budaSBtw6AgY29tcGlsZXIga2jDtG5nIGjhu4EgYsOhbyBs4buXaSENCi0gKipHaeG6o2kgcGjDoXAqKjogR29tIGPDoWMgdGhhbSBz4buRIHRow6BuaCBt4buZdCAqKlBhcmFtZXRlciBPYmplY3QgLyBEVE8qKiBjw7MgdMOqbiB0aHXhu5ljIHTDrW5oIHTGsOG7nW5nIG1pbmguDQoNCi0tLQ0KDQojIyMgNC4yLiBDTEkgRGlhZ25vc3RpY3MgJiBDw7RuZyBD4bulIMSQbyBMxrDhu51uZyBDb3VwbGluZw0KDQpgYGBiYXNoDQojIDEuIFBow6JuIHTDrWNoIG1hIHRy4bqtbiBwaOG7pSB0aHXhu5ljIGdp4buvYSBjw6FjIFBhY2thZ2VzIGLhurFuZyBKRGVwZW5kDQpqZGVwZW5kLXVpIHNyYy8NCg0KIyAyLiDEkG8gbMaw4budbmcgY2jhu4kgc+G7kSBraOG7m3AgbuG7kWkgQWZmZXJlbnQvRWZmZXJlbnQgY291cGxpbmcgYuG6sW5nIFB5Q0cgaG/hurdjIFJhZG9uDQpyYWRvbiByYXcgLXMgc3JjLw0KDQojIDMuIFF1w6l0IHTDrG0gY8OhYyBow6BtIGPDsyBkYW5oIHPDoWNoIHRoYW0gc+G7kSBxdcOhIGTDoGkgKExvbmcgUGFyYW1ldGVyIExpc3QpDQpsaXphcmQgc3JjLyAtYSA1DQpgYGANCg0KLS0tDQoNCiMjIDUuIELhuqNuZyBTbyBzw6FuaCAmIERlY2lzaW9uIE1hdHJpeA0KDQp8IENoaeG7gXUgS2jDtG5nIEdpYW4gU28gU8OhbmggfCBD4bqlcCDEkOG7mSBU4buTaSBU4buHIChD4bqnbiBMb+G6oWkgQuG7jykgfCBD4bqlcCDEkOG7mSBU4buRdCAoQ2h14bqpbiBN4buxYykgfCBD4bqlcCDEkOG7mSBMw70gVMaw4bufbmcgKFBow6JuIFTDoW4pIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqUGjhu5UgR2jDqXAgTuG7kWkgKENvdXBsaW5nKSoqIHwgQ29udGVudCBDb3VwbGluZywgQ29tbW9uIENvdXBsaW5nIHwgRGF0YSBDb3VwbGluZyAoVHJ1eeG7gW4gUGFyYW1ldGVycyBo4bq5cCl8IE1lc3NhZ2UgQ291cGxpbmcgKEV2ZW50IEJ1cyBi4bqldCDEkeG7k25nIGLhu5kpIHwNCnwgKipQaOG7lSBH4bqvbiBL4bq/dCAoQ29oZXNpb24pKiogfCBDb2luY2lkZW50YWwgQ29oZXNpb24gKFV0aWxzL0hlbHBlcikgfCBTZXF1ZW50aWFsIC8gQ29tbXVuaWNhdGlvbmFsIENvaGVzaW9uIHwgRnVuY3Rpb25hbCBDb2hlc2lvbiAoU2luZ2xlIFJlc3BvbnNpYmlsaXR5KXwNCnwgKipW4buLIFRyw60gVHLDqm4gQ2h14buXaSBDaMOtbmgqKiB8IFpvbmUgb2YgUGFpbiAoJEE9MCwgST0wJCkgfCBNYWluIFNlcXVlbmNlICgkQSArIEkgXGFwcHJveCAxJCkgfCBNYWluIFNlcXVlbmNlICgkRCA8IDAuMSQpIHwNCnwgKipUw6FjIMSQ4buZbmcgS2hpIFPhu61hIENvZGUqKiB8IEzhu5dpIGxhbiB0cnV54buBbiBkb21pbm8gdG/DoG4gaOG7hyB0aOG7kW5nIHwgQ2jhu4kg4bqjbmggaMaw4bufbmcgdHJvbmcgcGjhuqFtIHZpIG1vZHVsZSB8IEhvw6BuIHRvw6BuIGPDtCBs4bqtcCwga2jDtG5nIOG6o25oIGjGsOG7n25nIGFpIHwNCnwgKirEkOG7mSBLaMOzIEtoaSBWaeG6v3QgVW5pdCBUZXN0Kip8IFBo4bqjaSBk4buxbmcgdG/DoG4gYuG7mSBo4buHIHRo4buRbmcgZ2nhuqMgbOG6rXAgfCBE4buFIGTDoG5nIE1vY2tpbmcgcXVhIEludGVyZmFjZSB8IEPhu7FjIGvhu7MgxJHGoW4gZ2nhuqNuLCBraeG7g20gdGjhu60gxJHhu5ljIGzhuq1wIHwNCg==