1/*
2 * ============================================================================
3 *  TextBlocksPreview.java
4 * ============================================================================
5 *  Java 13 - TEXT BLOCKS (Önizleme / Preview Özelliği)
6 *
7 *  ÖNEMLİ NOT (Sürüm Bilgisi):
8 *  ---------------------------------------------------------------------------
9 *  - Text Blocks, Java 13'te (Eylül 2019) PREVIEW (önizleme) olarak geldi.
10 *    JEP 355 ile tanıtıldı.
11 *  - Java 14'te ikinci bir preview turu yaşadı (JEP 368). Bu turda \ (satır
12 *    sonu birleştirme) ve \s (boşluk koruma) kaçış dizileri eklendi.
13 *  - Java 15'te KALICI (kararlı/standard) hale geldi (JEP 378).
14 *
15 *  DERLEME TALİMATI:
16 *  ---------------------------------------------------------------------------
17 *  * Java 13 veya 14 ile derliyorsanız, önizleme özelliği açık olmalıdır:
18 *        javac --enable-preview --release 13 TextBlocksPreview.java
19 *        java  --enable-preview TextBlocksPreview
20 *
21 *    (Java 14 için --release 14 kullanın.)
22 *
23 *  * Java 15 ve sonrası ile derliyorsanız, Text Blocks artık KALICI olduğu
24 *    için herhangi bir özel bayrak GEREKMEZ:
25 *        javac TextBlocksPreview.java
26 *        java  TextBlocksPreview
27 *
28 *  Bu dosya, \ ve \s kaçış dizilerini de kullandığı için en sorunsuz şekilde
29 *  Java 15+ ile (preview bayrağı olmadan) derlenir. Java 13'te derlemek
30 *  isterseniz \ ve \s kullanan satırları Java 13'ün desteklemediğini unutmayın
31 *  (bunlar 14'te geldi); o satırlar yorumda ayrıca işaretlenmiştir.
32 * ============================================================================
33 */
34
35public class TextBlocksPreview {
36
37    public static void main(String[] args) {
38
39        System.out.println("=================================================");
40        System.out.println("   JAVA 13 - TEXT BLOCKS (Önizleme) ÖRNEKLERİ");
41        System.out.println("=================================================\n");
42
43        ornek1_JsonYazimi();
44        ornek2_SqlSorgusu();
45        ornek3_HtmlYazimi();
46        ornek4_GirintiYonetimi();
47        ornek5_KacisDizileri();
48        ornek6_GercekHayatRaporu();
49    }
50
51    /* ========================================================================
52     * ÖRNEK 1: JSON YAZIMI
53     * ------------------------------------------------------------------------
54     * PROBLEM: Java'da çok satırlı JSON metnini elle yazmak işkenceydi.
55     * Her satır için tırnak açıp kapatmak, satır sonuna \n koymak, satırları
56     * + ile birleştirmek ve JSON içindeki çift tırnakları \" diye kaçırmak
57     * gerekiyordu. Buna "kaçış karakteri cehennemi" (escape hell) denir.
58     * ====================================================================== */
59    static void ornek1_JsonYazimi() {
60        System.out.println("--- ÖRNEK 1: JSON YAZIMI ---\n");
61
62        /*
63         * ESKİ YÖNTEM (Java 12 ve öncesi):
64         * ---------------------------------
65         * Dikkat edin:
66         *   - Her satır ayrı bir String literal ("...").
67         *   - JSON içindeki her " işareti \" olarak kaçırılmış.
68         *   - Satır sonlarına \n elle eklenmiş.
69         *   - Satırlar + operatörü ile birleştirilmiş.
70         * Bu, okunması ve bakımı çok zor, hataya açık bir koddur.
71         */
72        String eskiJson =
73                "{\n" +
74                "    \"ad\": \"Ahmet\",\n" +
75                "    \"soyad\": \"Yılmaz\",\n" +
76                "    \"yas\": 30,\n" +
77                "    \"adres\": {\n" +
78                "        \"sehir\": \"İstanbul\",\n" +
79                "        \"ulke\": \"Türkiye\"\n" +
80                "    },\n" +
81                "    \"aktif\": true\n" +
82                "}";
83
84        System.out.println(">> ESKİ YÖNTEM (kaçış cehennemi):");
85        System.out.println(eskiJson);
86        System.out.println();
87
88        /*
89         * YENİ YÖNTEM (Java 13+ Text Block):
90         * -----------------------------------
91         * Üç çift tırnak (""") ile başlar ve biter.
92         * Açılış """ işaretinden SONRA mutlaka satır başı (yeni satır) gelmeli.
93         * İçeride:
94         *   - Çift tırnakları kaçırmaya GEREK YOK -> sade " yazabiliriz.
95         *   - Satır sonlarına \n koymaya GEREK YOK -> doğal satır sonları korunur.
96         *   - + ile birleştirmeye GEREK YOK.
97         * Sonuç: JSON metni tam olarak "göründüğü gibi" yazılır.
98         */
99        String yeniJson = """
100                {
101                    "ad": "Ahmet",
102                    "soyad": "Yılmaz",
103                    "yas": 30,
104                    "adres": {
105                        "sehir": "İstanbul",
106                        "ulke": "Türkiye"
107                    },
108                    "aktif": true
109                }""";
110
111        System.out.println(">> YENİ YÖNTEM (Text Block - temiz):");
112        System.out.println(yeniJson);
113        System.out.println();
114    }
115
116    /* ========================================================================
117     * ÖRNEK 2: SQL SORGUSU YAZIMI
118     * ------------------------------------------------------------------------
119     * Gerçek hayatta uygulama kodu içinde uzun SQL sorguları yazmak çok
120     * yaygındır. Eski yöntemde her satırın string birleştirmesi yapılır,
121     * boşluk koymayı unutmak yüzünden kelimeler birbirine yapışır
122     * (örn. "FROMmusteriler" gibi) ve sorgu bozulur.
123     * ====================================================================== */
124    static void ornek2_SqlSorgusu() {
125        System.out.println("--- ÖRNEK 2: SQL SORGUSU YAZIMI ---\n");
126
127        /*
128         * ESKİ YÖNTEM (Java 12 ve öncesi):
129         * Klasik tuzak: satır sonlarındaki boşluklar. "siparisler" ile "WHERE"
130         * arasında boşluk bırakmak için satır sonuna " " eklemek gerekir.
131         * Unutursanız "siparislerWHERE" olur ve sorgu çalışmaz.
132         */
133        String eskiSql =
134                "SELECT m.ad, m.soyad, s.tutar, s.tarih " +
135                "FROM musteriler m " +
136                "INNER JOIN siparisler s ON m.id = s.musteri_id " +
137                "WHERE s.tutar > 1000 " +
138                "  AND s.tarih >= '2024-01-01' " +
139                "ORDER BY s.tutar DESC";
140
141        System.out.println(">> ESKİ YÖNTEM (boşluk tuzaklı string birleştirme):");
142        System.out.println(eskiSql);
143        System.out.println();
144
145        /*
146         * YENİ YÖNTEM (Java 13+ Text Block):
147         * Sorgu tıpkı bir SQL editöründeymiş gibi okunabilir biçimde yazılır.
148         * Boşluk/satır sonu derdi yok. Bakımı çok kolaydır; yeni bir koşul
149         * eklemek için sadece yeni bir satır yazarsınız.
150         */
151        String yeniSql = """
152                SELECT m.ad, m.soyad, s.tutar, s.tarih
153                FROM musteriler m
154                INNER JOIN siparisler s ON m.id = s.musteri_id
155                WHERE s.tutar > 1000
156                  AND s.tarih >= '2024-01-01'
157                ORDER BY s.tutar DESC
158                """;
159
160        System.out.println(">> YENİ YÖNTEM (Text Block - okunaklı SQL):");
161        System.out.println(yeniSql);
162        System.out.println();
163    }
164
165    /* ========================================================================
166     * ÖRNEK 3: HTML YAZIMI
167     * ------------------------------------------------------------------------
168     * HTML içinde hem çift tırnak (attribute'lar: class="...") hem de iç içe
169     * yapı çoktur. Eski yöntemde bu tam bir kabustu.
170     * ====================================================================== */
171    static void ornek3_HtmlYazimi() {
172        System.out.println("--- ÖRNEK 3: HTML YAZIMI ---\n");
173
174        // ESKİ YÖNTEM: tüm tırnaklar \" ile kaçırılmış, çok zor okunur.
175        String eskiHtml =
176                "<html>\n" +
177                "    <body>\n" +
178                "        <h1 class=\"baslik\">Merhaba Dünya</h1>\n" +
179                "        <p id=\"aciklama\">Bu bir <b>Text Block</b> örneğidir.</p>\n" +
180                "    </body>\n" +
181                "</html>";
182
183        System.out.println(">> ESKİ YÖNTEM:");
184        System.out.println(eskiHtml);
185        System.out.println();
186
187        // YENİ YÖNTEM: tırnaklar olduğu gibi, yapı tam HTML gibi görünüyor.
188        String yeniHtml = """
189                <html>
190                    <body>
191                        <h1 class="baslik">Merhaba Dünya</h1>
192                        <p id="aciklama">Bu bir <b>Text Block</b> örneğidir.</p>
193                    </body>
194                </html>""";
195
196        System.out.println(">> YENİ YÖNTEM (Text Block):");
197        System.out.println(yeniHtml);
198        System.out.println();
199    }
200
201    /* ========================================================================
202     * ÖRNEK 4: GİRİNTİ YÖNETİMİ (INCIDENTAL WHITESPACE)
203     * ------------------------------------------------------------------------
204     * Text Block'larda kodun girintisi (sol taraftaki boşluklar) ile metnin
205     * gerçek girintisini ayırmak gerekir. Derleyici, "tesadüfi boşluk"
206     * (incidental whitespace) dediğimiz, sadece kodu hizalamak için var olan
207     * boşlukları otomatik olarak siler.
208     *
209     * KURAL: Tüm satırlar (kapanış """ dahil) içinde EN SOLDA başlayan satır
210     * referans alınır. O satırın solundaki boşluk miktarı kadar boşluk tüm
211     * satırlardan kırpılır. Kapanış """ konumu bu referansı belirlemede
212     * çok etkilidir.
213     * ====================================================================== */
214    static void ornek4_GirintiYonetimi() {
215        System.out.println("--- ÖRNEK 4: GİRİNTİ YÖNETİMİ ---\n");
216
217        /*
218         * Burada kapanış """ işareti, metnin başlamasını istediğimiz sütunda.
219         * Bu yüzden satırların başındaki "kod hizalama" boşlukları silinir,
220         * metin sola dayalı çıkar.
221         */
222        String solaDayali = """
223                Satir 1
224                Satir 2
225                Satir 3
226                """;
227        System.out.println(">> Sola dayalı (incidental whitespace silindi):");
228        System.out.println(solaDayali);
229
230        /*
231         * Şimdi bilerek girinti EKLİYORUZ. Kapanış """ işaretini daha sola
232         * çekersek, ona göre satırların başındaki fazladan boşluklar KORUNUR.
233         * Aşağıda "    Girintili" satırı, kapanış """ ye göre 4 boşluk içeride.
234         */
235        String girintili = """
236                    Girintili satir
237                Normal satir
238                """;
239        System.out.println(">> Bilinçli girinti korundu:");
240        System.out.println(girintili);
241    }
242
243    /* ========================================================================
244     * ÖRNEK 5: KAÇIŞ DİZİLERİ (\ satır devamı ve \s boşluk koruma)
245     * ------------------------------------------------------------------------
246     * DİKKAT: \ (satır birleştirme) ve \s (boşluk koruma) kaçış dizileri
247     * Java 14'te (ikinci preview) eklendi. Java 13'te BU İKİSİ YOKTUR.
248     * Bu yüzden bu örnek en güvenli şekilde Java 14+ ile derlenir.
249     * ====================================================================== */
250    static void ornek5_KacisDizileri() {
251        System.out.println("--- ÖRNEK 5: \\ ve \\s KAÇIŞ DİZİLERİ (Java 14+) ---\n");
252
253        /*
254         * \ (ters bölü + satır sonu): O noktadaki YENİ SATIR karakterini
255         * iptal eder. Yani kaynak kodda satırı bölersiniz ama çıktıda tek
256         * satır olur. Çok uzun tek satırlık metinleri okunaklı yazmak için
257         * idealdir.
258         */
259        String tekSatir = """
260                Bu cumle kaynak kodda \
261                bolundu ama ciktida \
262                tek satir olarak gorunur.""";
263        System.out.println(">> \\ ile satır devamı (çıktıda tek satır):");
264        System.out.println(tekSatir);
265        System.out.println();
266
267        /*
268         * \s: Tam olarak bir boşluk (space) karakterini temsil eder ve
269         * kendisinden önceki sondaki boşlukların (trailing whitespace)
270         * kırpılmasını ENGELLER. Sondaki boşlukların korunması gerektiğinde
271         * (örn. sabit genişlikli sütunlar) kullanılır.
272         */
273        String bosluklar = """
274                Ad     \s
275                Soyad  \s
276                """;
277        System.out.println(">> \\s ile sondaki boşluklar korundu (| ile gösterim):");
278        for (String satir : bosluklar.split("\n")) {
279            System.out.println("|" + satir + "|");
280        }
281        System.out.println();
282    }
283
284    /* ========================================================================
285     * ÖRNEK 6: GERÇEK HAYAT - DİNAMİK RAPOR / E-POSTA ŞABLONU
286     * ------------------------------------------------------------------------
287     * Text Block + String.formatted() (Java 15'te eklendi, formatlı metin için)
288     * birlikte kullanılarak şablonlu çıktı üretmek çok temiz olur.
289     * Burada formatted yerine taşınabilirlik için klasik String.format
290     * kullanıyoruz; ikisi de aynı işi yapar.
291     * ====================================================================== */
292    static void ornek6_GercekHayatRaporu() {
293        System.out.println("--- ÖRNEK 6: GERÇEK HAYAT - E-POSTA ŞABLONU ---\n");
294
295        String musteriAdi = "Zeynep Kaya";
296        String siparisNo = "SP-2024-00917";
297        double tutar = 1499.90;
298
299        String sablon = """
300                Sayın %s,
301
302                %s numaralı siparişiniz başarıyla alınmıştır.
303                Toplam tutar: %.2f TL
304
305                Bizi tercih ettiğiniz için teşekkür ederiz.
306                İyi günler dileriz.
307
308                ABC Mağazacılık A.Ş.
309                """;
310
311        String email = String.format(sablon, musteriAdi, siparisNo, tutar);
312
313        System.out.println(">> Üretilen e-posta:");
314        System.out.println(email);
315    }
316}