Java 14'de neler var - 3



JEP 368: Text Blocks (Second Preview)[Ref]

Yıllardır yazdığımız kodlar içine birden fazla satırdan olaşan text-metin eklemek istediğimizde çektiğimiz sıkınıtıyı ancak bizler gibi yaşayan bilir.

Artık bu eziyet son bulacak gibi görünüyor. Böylece string içinde kullandığımız bazı özel karakterleri escape yapmaktan kurtuluyoruz hem de istediğimiz format – biçimde birden fazla satırdan oluşan bir metni kodumuzun içerisine rahatlıkla gömebiliyoruz.

Text blok (two-dimensional) olarak tanımlanan bu yeni tip, sıfır veya daha fazla karaketerden oluşabilir.

Başlangıç ayracı """  ı takip eden sıfır veya daha fazla boşluk karakteri ve arkasından bir adet satır sonu karakteri olacak şekilde tanımlanmış. Bitiş ayracı ise """ olacak şekilde tanımlanmış. İçerik bir sonraki satırın başından itbaren başlar.

Eski tür kullanım ise one-dimensional olarak tanımlanıyor ve “ (bir adet çift tırnak) ile başlayıp bitiyordu.

Blok içeriğinde " karakteri bulunabildiği gibi \" de kulanılabilir ama gerekli değildir ve önerilmez. Ayrıca satır sonları blok içinde doğal olarak kullanılabilir ya da \n de önerilmese de kullanılabilir.

Özetle aşağıdaki ifadeler aynı sonucu üretmektedir. 


1
2
3
4
5
 """
 line 1
 line 2
 line 3
 """


1
 "line 1\nline 2\nline 3\n"


1
2
3
 "line 1\n" +
 "line 2\n" +
 "line 3\n"

Eğer blok sonunda satır sonu gerekmiyorsa, bitiş ayracı son blok sonunda da bulunabilir : 

1
2
3
4
 """
 line 1
 line 2
 line 3"""

Text bloğun içi boş olabilir ama önerilmez çünkü tanım için iki satır gereklidir. 

1
2
 String empty = """
                """;

Bir de hatalı kullanımlara bakalım : 

1
2
3
4
5
6
7
 String a = """""";   // başlangıç ayracı sonrası alt satıra geçmemiş
 String b = """ """;  // başlangıç ayracı sonrası alt satıra geçmemiş
 String c = """
            ";        // kapanış ayracı konulmamış (text bloğu dosya sonunda biter)
 String d = """
            abc \ def
            """;      // backslash karakteri escape yapılmamış (daha sonra detaylı anlatılacak)

Çokca rastlanılan örneklerden html, sql ve javascript için örnekler aşağıda. Bugüne kadar html içeriği olan bir metni eklemek için yapmamız gereken kodlama şöyle bir şey idi (one-dimensional): 

1
2
3
4
5
6
7
 String html = "<html>\n" +
         "    <body>\n" +
   "        <p>Hello, world</p>\n" +
  "    </body>\n" +
  "</html>\n";

 System.out.println(html);

artık bu şekilde kullanabiliyoruz (two-dimensional ): 

1
2
3
4
5
6
7
8
9
 String html = """
         <html>
     <body>
        <p>Hello, world</p>
      </body>
  </html>
  """;
 
 System.out.println(html);



     [java] <html>
     [java]     <body>
     [java]         <p>Hello, world</p>
     [java]     </body>
     [java] </html>

     [java] <html>
     [java]     <body>
     [java]         <p>Hello, world</p>
     [java]     </body>
     [java] </html>



1
2
3
4
5
 String query = "SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`\n" +
  "WHERE `CITY` = 'INDIANAPOLIS'\n" +
  "ORDER BY `EMP_ID`, `LAST_NAME`;\n";
  
 System.out.println(query);



1
2
3
4
5
6
 String query = """
  SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
  WHERE `CITY` = 'INDIANAPOLIS'
  ORDER BY `EMP_ID`, `LAST_NAME`;
  """;
 System.out.println(query);



     [java] SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
     [java] WHERE `CITY` = 'INDIANAPOLIS'
     [java] ORDER BY `EMP_ID`, `LAST_NAME`;

     [java] SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
     [java] WHERE `CITY` = 'INDIANAPOLIS'
     [java] ORDER BY `EMP_ID`, `LAST_NAME`;



1
2
3
4
5
 obj = engine.eval("function hello() {\n" +
     "    print('\"Hello, world\"');\n" +
     "}\n" +
     "\n" +
     "hello();\n");



1
2
3
4
5
6
7
 obj = engine.eval("""
     function hello() {
        print('"Hello, world"');
     }
                           
     hello();
     """);



     [java] "Hello, world"

     [java] "Hello, world"


Yeni Escape Karakterler

Yeni eklenen bu string tipi ile birlikte iki yeni escape karakteri ile de tanışmamız gerekiyor. Birincisi \<satır sonu> karakteri. Bu karakteri blok içinde kullandığınız zaman artık string içinde değil ama kod içinde alt satıra geçip devam edebilirsiniz. Örneğin çok uzun string satırlarını okunabilir kılmak için alt satıra geçip yazmaya devam ettiğimiz zamanda olduğu gibi. 


1
2
3
 String literal = "Lorem ipsum dolor sit amet, consectetur adipiscing " +
                  "elit, sed do eiusmod tempor incididunt ut labore " +
                  "et dolore magna aliqua.";

Eğer text bloğu kullanıyorsak şöyle olacak : 


1
2
3
4
5
 String text = """
                 Lorem ipsum dolor sit amet, consectetur adipiscing \
                 elit, sed do eiusmod tempor incididunt ut labore \
                 et dolore magna aliqua.\
                 """;



 [java] literal => Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

 [java] text => Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

tabi bu escape karakter sadece text bloklarda geçerli ama eski tip string tanımlarında kullanılamaz.

İkinci karakterimiz ise \s karakteri ki tek bir boşluk karakterine karşılık gelmektedir. Escape karakterler, strip işlemi yapılıp bitene kadar derleyici tarafından işlenmezler. Bu nedenle boşluk karakterleri sonrasına eklenen \s bir nevi strip işlemine karşı kendinden önceki boşlukları koruma görevi yapacaktır.

Mesela aşağıdaki satır sonlarındaki \s karakteri kendinden önceki boşluklar için strip işlemini engelleyerek her satırın 6 karakter boyunda olmasını garanti edecektir : 


1
2
3
4
5
 String colors = """
     red  \s
     green\s
     blue \s
     """;

\s karakteri hem test bloklarında hem de geleneksel string tanımlarında kullanılabilir.

Text Blokları Birbirine Ekleme İşlemi

Text blokları string kullanılan her yerde kullanılabildiği gibi birbirilerine de eklenebilirler. 

1
2
3
4
5
 String code = "public void print(Object o) {" +
               """
                   System.out.println(Objects.toString(o));
               }
               """;


Fakat bazı durumlarda bu kullanım çok şık sonuçlar üretmeyebilir.

Mesela; 

1
2
3
4
5
 String code = """
               public void print(Object o) {
                   System.out.println(Objects.toString(o));
               }
               """;


Diyelim ki fonksiyonun parameteresi bir başka değişkenden gelecek ve dinamik olacak. Bu durumda araya değişken eklersek, """ sonrası satır başı yapmamız zorunlu olduğundan ve görsel biçimi de bozmak istemediğimizden "type" ve "o" arasına bir sürü gereksiz boşluk doldurmak zorunda kalacağız. 

1
2
3
4
5
6
 String code = """
               public void print(""" + type + """
                                                  o) {
                   System.out.println(Objects.toString(o));
               }
               """;


Oysa ki elimizde seçeneklerimiz var. Örneğin String::replace veya String::format kullanmak. 

1
2
3
4
5
 String code = """
               public void print($type o) {
                   System.out.println(Objects.toString(o));
               }
               """.replace("$type", type);



1
2
3
4
5
 String code = String.format("""
               public void print(%s o) {
                   System.out.println(Objects.toString(o));
               }
               """, type);


Diğer bir seçenek ise yeni eklenen String::formatted metodunu kullanmak. 

1
2
3
4
5
 String source = """
                 public void print(%s object) {
                     System.out.println(Objects.toString(object));
                 }
                 """.formatted(type);



     [java] public void print(Array o) {
     [java]     System.out.println(Objects.toString(o));
     [java] }

     [java] public void print(Array o) {
     [java]     System.out.println(Objects.toString(o));
     [java] }

     [java] public void print(Array object) {
     [java]     System.out.println(Objects.toString(object));
     [java] }


Yeni Gelen Metodlar

Text Blokları desteklemek amaçlı aşağıdaki metodlar eklenmiş
  • String::stripIndent(): text blok içindeki boşlukarı temizler.
  • String::translateEscapes():text blok içindeki escape karakterleri dönüştürür
  • String::formatted(Object... args): string içindeki değişkenleri argüman listesi ile değiştirir.


Bu metodlardan üçüncüyü zaten yukarıda kullandık. Diğer ikisinin nasıl çalıştığını anlamak için de aşağıda görebilirsiniz. 


1
2
3
4
 data = readFileAsString();
 System.out.println(data);
 System.out.println(data.stripIndent());
 System.out.println(data.stripIndent().translateEscapes());



     [java]                                                                     <html>
     [java]                                                                             <body>
     [java]                                                                                     <p>Hello, world</p>
     [java]                                                                                     Merhaba \\n\\nBen \\"geldim\\"
     [java]                                                                             </body>
     [java]                                                                     </html>
     
     [java] <html>
     [java]     <body>
     [java]             <p>Hello, world</p>
     [java]             Merhaba \\n\\nBen \\"geldim\\"
     [java]     </body>
     [java] </html>
     
     [java] <html>
     [java]     <body>
     [java]             <p>Hello, world</p>
     [java]             Merhaba
     [java]
     [java] Ben "geldim"
     [java]     </body>
     [java] </html>

Örnekleri içeren Java koduna buradan erişebilirsiniz.

Çalıştırmak için : 


ant runjep368

Detaylarını merak ediyorsanız alt başlıkta bağlantısı verilen referans dokümana bakabilirsiniz.

Comments

Post a Comment

Popular posts from this blog

Automation of daily build process with TlosLite

The aim of this paper is to describe the importance of job scheduler for build automation. This sample use case  is the daily build process of our new product Tlos Space Wide , the comprehensive workload automation solution . The build process is managed by our Open Source Free Job Scheduler TlosLite v1.8.1  which can be downloaded from here .  With the help of the scheduler, the committed sources are built on daily basis and generates an email according to the build process result if success or fail. A windows based system is considered for this case. The purpose of using a scheduler is to define the build process by steps and chain the steps to be managed by the scheduler so as to detect any failures on the relevant steps without losing the whole job flow. This is really a lifesaving process if your process is complicated and includes lots of jobs. In our case the build process does not have so many steps but if you are dealing with some kind of ETL, then the jo
Read more

Java Sürümleri ve Özellikleri Kılavuzu

Image
Farklı Java sürümleri ve özellikleri hakkında bilmeniz gereken her şey Hangi Java Sürümünü Kullanmalıyım ? 17 Mart itibarı ile ilk Jdk 14 sürümü yayınlandı. Plana göre de her 6 ayda bir yeni bir sürüm yayınlanacak misal Java 15 Eylül 2020 gibi bekleniyor. Oracle Sun’ı satın aldıktan sonra (27.01.2010) bir süre daha sürüm takvimi geçmişte olduğu gibi devam etti ve bu takvime göre sürümler arası geçen zaman 3-5 yılı buluyordu. Java 9 yayın tarihi sürekli değişti ve planlanan tarihten çok sonra yayınlanabildi (09.17) ve sonrasında da 6 aylık sürüm takvimine geçildi. Ancak gerçek hayatta işler biraz farklı ilerliyor. Sürüm takvimi bugün Java14’ü gösterse de çoğu uygulama Java 8’e bile geç adapte olabildi ( Neden bazı şirketler hala Java 8’e takılıp kaldılar ? ) bir kısmı daha da eskilerde kaldı. Eğer yeni bir projeye başlamayı planlıyorsanız Java 11 (LTS - Life Time Support) ya da Java 14 sürümü ile rahatlıkla başlayabilirsiniz. Android uygulaması yazmak istiyorsanız b
Read more

Java 14'de neler var - 1

Image
Java 14 sürümü 17 Mart tarihi itibariyle kullanıma sunuldu. Ben de bir süredir Jdk 'daki yeniliklerden uzak kaldığım için kendimi de güncellemek amaçlı OpenJDK sitesinde listelenen yenilikleri gözden geçirdim. Yaptığım çalışmaları da hem kod hem de yorumlarım ile paylaşıyorum. Java14 kullanmak isterseniz Oracle ve AdoptOpenJdk 'dan indirebilirsiniz. Diğer dağıtıcılar da zamanla hazır olacaklardır. Yeni eklenen özelliklerin bir kısmı kodlama ile ilgiliyken bir kısmı da Jvm ya da araçlar ile ilgili. Yenilikler JEP - JDK Enhancement Proposal ler üzerinden takip ediliyor ve bu sürümde 16 tane JEP eklenmiş. Bunlardan üç tanesi Preview - Ön izleme 2 tanesi ise Incubator - kuluçka etiketi ile sunulmuş. JEP-305 : Pattern Matching for instanceof (Preview) [ Ref ] Daha önce instanceof operatörü kullanırken test ettiğimiz nesne tipi eğer istediğimiz nesnenin bir türevi ise kullanmadan önce type casting yapmamız, yani tipini vermemiz gerekiyordu.  Örneğin eskiden şu ş
Read more