Telegram botlar\u0131, kullan\u0131c\u0131larla etkile\u015fim kurman\u0131n ve \u00e7e\u015fitli otomasyon g\u00f6revlerini yerine getirmenin g\u00fc\u00e7l\u00fc bir yolunu sunar. Mevcut bir\u00e7ok Java Telegram bot k\u00fct\u00fcphanesi olsa da, bazen projenin \u00f6zel ihtiya\u00e7lar\u0131na tam olarak uyan, daha hafif ve \u00fczerinde tam kontrole sahip bir \u00e7\u00f6z\u00fcm geli\u015ftirmek isteyebiliriz. Bu makalede, Java ile minimal bir Telegram bot k\u00fct\u00fcphanesi olu\u015fturman\u0131n temel ad\u0131mlar\u0131n\u0131, \u00f6zellikle de esnek ve geni\u015fletilebilir bir yap\u0131 sa\u011flayan Handler Zinciri Deseni (Chain of Responsibility Pattern) yakla\u015f\u0131m\u0131n\u0131 kullanarak inceleyece\u011fiz.<\/p>\n
Telegram Bot API, geli\u015ftiricilerin botlar\u0131n\u0131 Telegram platformuyla entegre etmelerini sa\u011flayan bir HTTP tabanl\u0131 aray\u00fczd\u00fcr. Botunuzun kullan\u0131c\u0131larla etkile\u015fim kurabilmesi i\u00e7in bu API’yi anlamak kritik \u00f6neme sahiptir.<\/p>\n
Telegram Bot API, RESTful prensiplere dayan\u0131r ve HTTPS \u00fczerinden istekler al\u0131r. Botunuz, API’ye belirli metodlar\u0131 \u00e7a\u011f\u0131rarak mesaj g\u00f6nderebilir, kullan\u0131c\u0131 bilgilerini alabilir veya dosya y\u00fckleyebilir. Her bot, benzersiz bir token ile tan\u0131mlan\u0131r ve t\u00fcm API istekleri bu token ile kimlik do\u011frulamas\u0131 gerektirir.<\/p>\n
Kullan\u0131c\u0131lar botunuzla etkile\u015fime ge\u00e7ti\u011finde (mesaj g\u00f6nderme, komut kullanma, inline sorgu vb.), Telegram sunucular\u0131 botunuza “g\u00fcncelleme” (update) g\u00f6nderir. Her g\u00fcncelleme, bir JSON nesnesi olarak gelir ve i\u00e7inde bir veya daha fazla olay t\u00fcr\u00fcn\u00fc bar\u0131nd\u0131rabilir (\u00f6rne\u011fin, <\/code><\/p>\n Botunuzun gelen g\u00fcncellemeleri almas\u0131n\u0131n iki ana yolu vard\u0131r:<\/p>\n Telegram botlar\u0131 genellikle Piyasada zaten bir\u00e7ok kapsaml\u0131 Telegram bot k\u00fct\u00fcphanesi varken, kendi minimal \u00e7\u00f6z\u00fcm\u00fcm\u00fcz\u00fc geli\u015ftirmek baz\u0131 durumlarda avantajl\u0131 olabilir.<\/p>\n B\u00fcy\u00fck k\u00fct\u00fcphaneler genellikle \u00e7ok say\u0131da \u00f6zelli\u011fi ve soyutlamay\u0131 i\u00e7erir. Bu durum, \u00f6\u011frenme e\u011frisini art\u0131rabilir, gereksiz ba\u011f\u0131ml\u0131l\u0131klar getirebilir ve uygulaman\u0131n boyutunu \u015fi\u015firebilir. Bazen, projenin ihtiyac\u0131 olan tek \u015fey basit bir mesaj i\u015fleme mekanizmas\u0131d\u0131r ve bu durumda a\u011f\u0131r bir k\u00fct\u00fcphane a\u015f\u0131r\u0131ya ka\u00e7abilir.<\/p>\n Kendi k\u00fct\u00fcphanenizi yazd\u0131\u011f\u0131n\u0131zda, her bir bile\u015fen \u00fczerinde tam kontrole sahip olursunuz. Bu, uygulaman\u0131z\u0131n tam olarak istedi\u011finiz gibi davranmas\u0131n\u0131 sa\u011flar ve gelecekteki de\u011fi\u015fiklikler veya \u00f6zel entegrasyonlar i\u00e7in maksimum esneklik sunar. \u00d6rne\u011fin, \u00f6zel bir g\u00fcncelleme i\u015fleme mant\u0131\u011f\u0131 veya farkl\u0131 bir HTTP istemcisi kullanmak istedi\u011finizde, mevcut k\u00fct\u00fcphanelerin k\u0131s\u0131tlamalar\u0131na tak\u0131lmazs\u0131n\u0131z.<\/p>\n S\u0131f\u0131rdan bir k\u00fct\u00fcphane geli\u015ftirmek, Telegram Bot API'sinin ve genel yaz\u0131l\u0131m tasar\u0131m desenlerinin derinlemesine anla\u015f\u0131lmas\u0131n\u0131 sa\u011flar. Bu s\u00fcre\u00e7, sadece bot geli\u015ftirme becerilerinizi de\u011fil, ayn\u0131 zamanda genel yaz\u0131l\u0131m m\u00fchendisli\u011fi bilginizi de geli\u015ftirir. Bir problemi temelden \u00e7\u00f6zmek, soyutlamalar\u0131n arkas\u0131nda yatan mekanizmalar\u0131 kavraman\u0131za yard\u0131mc\u0131 olur.<\/p>\n Minimal bir k\u00fct\u00fcphane, sadece ihtiya\u00e7 duyulan \u00f6zellikleri i\u00e7erdi\u011fi i\u00e7in daha az bellek t\u00fcketir ve daha h\u0131zl\u0131 \u00e7al\u0131\u015fabilir. Gereksiz \u00f6zelliklerin ve ba\u011f\u0131ml\u0131l\u0131klar\u0131n olmamas\u0131, uygulaman\u0131z\u0131n daha hafif ve verimli olmas\u0131n\u0131 sa\u011flar. \u00d6zellikle k\u0131s\u0131tl\u0131 kaynaklara sahip ortamlarda (\u00f6rne\u011fin, k\u00fc\u00e7\u00fck sunucular veya konteynerler) bu durum \u00f6nemli bir avantaj haline gelebilir.<\/p>\n Handler Zinciri Deseni (Chain of Responsibility Pattern), bir iste\u011fi i\u015fleyebilecek nesnelerin bir zincirini olu\u015fturarak, g\u00f6nderen ve al\u0131c\u0131 aras\u0131ndaki ba\u011f\u0131ml\u0131l\u0131\u011f\u0131 ortadan kald\u0131ran davran\u0131\u015fsal bir tasar\u0131m desenidir.<\/p>\n Bu desen, bir iste\u011fin birden fazla nesne taraf\u0131ndan i\u015flenebilece\u011fi durumlarda kullan\u0131l\u0131r. Her nesne, iste\u011fi i\u015fleyip i\u015fleyemeyece\u011fini kontrol eder. E\u011fer i\u015fleyebiliyorsa i\u015fler, aksi takdirde iste\u011fi zincirdeki bir sonraki nesneye iletir. Bu, iste\u011fi g\u00f6nderen taraf\u0131n, iste\u011fi kimin i\u015fleyece\u011fini bilmek zorunda kalmamas\u0131n\u0131 sa\u011flar.<\/p>\n Handler Zinciri Deseni genellikle \u015fu bile\u015fenlerden olu\u015fur:<\/p>\n Bir istek geldi\u011finde, zincirin ba\u015f\u0131ndaki handler'a g\u00f6nderilir. Bu handler, iste\u011fi i\u015fleyip i\u015fleyemedi\u011fine karar verir. E\u011fer i\u015fleyemezse, iste\u011fi zincirdeki bir sonraki handler'a iletir ve bu i\u015flem, istek i\u015flenene veya zincirin sonuna ula\u015f\u0131lana kadar devam eder.<\/p>\n Avantajlar\u0131:<\/strong><\/p>\n Dezavantajlar\u0131:<\/strong><\/p>\n Telegram botlar\u0131nda, her gelen g\u00fcncelleme (\u00f6rne\u011fin, bir mesaj) bir istek olarak d\u00fc\u015f\u00fcn\u00fclebilir. Farkl\u0131 handler'lar, farkl\u0131 mesaj t\u00fcrlerini (metin mesajlar\u0131, komutlar, foto\u011fraf mesajlar\u0131 vb.) veya belirli ko\u015fullar\u0131 (kullan\u0131c\u0131n\u0131n yetkisi, mesaj\u0131n i\u00e7eri\u011fi) i\u015fleyebilir. \u00d6rne\u011fin, bir handler Minimal k\u00fct\u00fcphanemizin temelini olu\u015fturacak s\u0131n\u0131flar\u0131 ve aray\u00fczleri tan\u0131mlayal\u0131m. Bu bile\u015fenler, Handler Zinciri Deseni'ni Java'da uygulamak i\u00e7in gerekli yap\u0131 ta\u015flar\u0131n\u0131 sa\u011flayacakt\u0131r.<\/p>\n Telegram API'den gelen JSON yan\u0131tlar\u0131n\u0131 Java nesnelerine d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in basit POJO (Plain Old Java Object) s\u0131n\u0131flar\u0131na ihtiyac\u0131m\u0131z var. Bu s\u0131n\u0131flar, sadece gerekli alanlar\u0131 i\u00e7erecek \u015fekilde minimal tutulmal\u0131d\u0131r. \u00d6rne\u011fin, bir <\/code><\/p>\n Bu modelleri JSON'dan Java nesnelerine d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in Gson veya Jackson gibi hafif bir JSON k\u00fct\u00fcphanesi kullanabiliriz.<\/p>\n Handler Zinciri Deseni'nin kalbi olan <\/code><\/p>\n <\/code><\/p>\n <\/code><\/p>\n K\u00fct\u00fcphanemizin temel bile\u015fenlerini tan\u0131mlad\u0131ktan sonra, \u015fimdi somut handler'lar\u0131 nas\u0131l olu\u015fturaca\u011f\u0131m\u0131z\u0131 ve bunlar\u0131 zincire nas\u0131l ekleyece\u011fimizi inceleyelim.<\/p>\n Farkl\u0131 mesaj t\u00fcrlerini veya komutlar\u0131 i\u015flemek i\u00e7in \u00e7e\u015fitli <\/code><\/p>\n <\/code><\/p>\n Handler'lar\u0131n zincire eklenme s\u0131ras\u0131, i\u015fleme \u00f6nceli\u011fini belirler. Daha spesifik veya \u00f6ncelikli olmas\u0131 gereken handler'lar zincirin ba\u015f\u0131na eklenmelidir. \u00d6rne\u011fin, Her handler'\u0131n K\u00fct\u00fcphanemizi ve handler zincirimizi kurduktan sonra, botumuzu nas\u0131l \u00e7al\u0131\u015ft\u0131raca\u011f\u0131m\u0131z\u0131 ve gelen mesajlar\u0131 nas\u0131l i\u015fleyece\u011fimizi ele alal\u0131m.<\/p>\n Minimal k\u00fct\u00fcphanemiz i\u00e7in Long Polling, g\u00fcncellemeleri almak i\u00e7in basit ve etkili bir y\u00f6ntemdir. Botumuz, belirli aral\u0131klarla Telegram API'den g\u00fcncellemeleri \u00e7ekecek bir d\u00f6ng\u00fc i\u00e7inde \u00e7al\u0131\u015f\u0131r.<\/p>\n <\/code><\/p>\n Her yeni g\u00fcncelleme al\u0131nd\u0131\u011f\u0131nda, Handler'lar, gelen g\u00fcncellemeleri i\u015fledikten sonra kullan\u0131c\u0131lara yan\u0131t g\u00f6ndermek isteyebilir. Bu, Minimal k\u00fct\u00fcphanemiz temel i\u015flevselli\u011fi sa\u011flasa da, daha g\u00fc\u00e7l\u00fc ve \u00fcretim ortam\u0131na uygun bir bot i\u00e7in baz\u0131 iyile\u015ftirmeler ve geni\u015fletmeler yap\u0131labilir.<\/p>\n Long polling d\u00f6ng\u00fcs\u00fc i\u00e7inde her g\u00fcncellemenin senkronize olarak i\u015flenmesi, yo\u011fun botlarda performans sorunlar\u0131na yol a\u00e7abilir. Her g\u00fcncellemeyi ayr\u0131 bir i\u015f par\u00e7ac\u0131\u011f\u0131nda (thread) veya bir i\u015f kuyru\u011funda (thread pool) asenkron olarak i\u015flemek, botun daha h\u0131zl\u0131 yan\u0131t vermesini ve birden fazla g\u00fcncellemeyi e\u015f zamanl\u0131 olarak i\u015flemesini sa\u011flar. Java'n\u0131n <\/code><\/p>\n Botunuzun kullan\u0131c\u0131 verilerini, sohbet ge\u00e7mi\u015fini veya \u00f6zel ayarlar\u0131 saklamas\u0131 gerekti\u011finde bir veritaban\u0131 entegrasyonu \u015fartt\u0131r. PostgreSQL, MySQL veya MongoDB gibi veritabanlar\u0131 kullan\u0131labilir. Handler'lar, veritaban\u0131 i\u015flemlerini ger\u00e7ekle\u015ftirmek i\u00e7in bir Repository veya DAO (Data Access Object) katman\u0131yla etkile\u015fime girebilir.<\/p>\n \u00dcretim ortam\u0131nda \u00e7al\u0131\u015fan bir botun sa\u011flam bir hata y\u00f6netimi ve loglama mekanizmas\u0131na sahip olmas\u0131 gerekir. Log4j2 veya SLF4J gibi loglama k\u00fct\u00fcphaneleri kullanarak botun davran\u0131\u015f\u0131n\u0131, gelen g\u00fcncellemeleri, API hatalar\u0131n\u0131 ve i\u015fleme hatalar\u0131n\u0131 kaydedebiliriz. Handler'lar i\u00e7inde try-catch bloklar\u0131 kullanarak hatalar\u0131 yakalamak ve uygun \u015fekilde loglamak \u00f6nemlidir.<\/p>\n Daha karma\u015f\u0131k botlar i\u00e7in, sadece Java ile minimal bir Telegram bot k\u00fct\u00fcphanesi olu\u015fturmak, sadece Telegram Bot API'sini de\u011fil, ayn\u0131 zamanda yaz\u0131l\u0131m tasar\u0131m desenlerini ve genel Java programlama prensiplerini de derinlemesine anlamak i\u00e7in harika bir yoldur. Handler Zinciri Deseni'ni kullanarak, botunuzun mesaj i\u015fleme mant\u0131\u011f\u0131n\u0131 esnek, geni\u015fletilebilir ve y\u00f6netilebilir bir \u015fekilde tasarlayabilirsiniz. Bu yakla\u015f\u0131m, projenizin \u00f6zel ihtiya\u00e7lar\u0131na g\u00f6re \u00f6zelle\u015ftirilmi\u015f, hafif ve performansl\u0131 bir \u00e7\u00f6z\u00fcm sunar. Kendi k\u00fct\u00fcphanenizi geli\u015ftirmek, size tam kontrol ve esneklik sa\u011flayarak, botunuzu gelecekteki gereksinimlere kolayca adapte etme imkan\u0131 verir.<\/p>\n 1. Neden haz\u0131r k\u00fct\u00fcphaneler yerine kendi minimal k\u00fct\u00fcphanemizi yazmal\u0131y\u0131z?<\/strong><\/p>\n Kendi k\u00fct\u00fcphanenizi yazmak, size tam kontrol ve esneklik sa\u011flar. Gereksiz ba\u011f\u0131ml\u0131l\u0131klardan ka\u00e7\u0131narak daha hafif ve performansl\u0131 bir uygulama olu\u015fturabilirsiniz. Ayr\u0131ca, bu s\u00fcre\u00e7 Telegram API'sini ve tasar\u0131m desenlerini daha iyi anlaman\u0131za yard\u0131mc\u0131 olur.<\/p>\n 2. Handler Zinciri Deseni ba\u015fka nerede kullan\u0131labilir?<\/strong><\/p>\n Handler Zinciri Deseni, bir iste\u011fin birden fazla nesne taraf\u0131ndan i\u015flenebilece\u011fi her yerde kullan\u0131labilir. \u00d6rne\u011fin, bir web uygulamas\u0131nda HTTP isteklerini filtrelemek, bir e-ticaret uygulamas\u0131nda sipari\u015f i\u015fleme ad\u0131mlar\u0131n\u0131 y\u00f6netmek veya bir belge i\u015fleme sisteminde farkl\u0131 dosya t\u00fcrlerini ayr\u0131\u015ft\u0131rmak gibi senaryolarda etkili bir \u015fekilde uygulanabilir.<\/p>\n 3. Minimal k\u00fct\u00fcphanemizde performans sorunlar\u0131 ya\u015far m\u0131y\u0131m?<\/strong><\/p>\n Do\u011fru tasarlanm\u0131\u015f ve optimize edilmi\u015f bir minimal k\u00fct\u00fcphane genellikle haz\u0131r, daha kapsaml\u0131 k\u00fct\u00fcphanelere g\u00f6re daha iyi performans g\u00f6sterebilir \u00e7\u00fcnk\u00fc sadece ihtiya\u00e7 duyulan i\u015flevselli\u011fi i\u00e7erir. Ancak, Long Polling d\u00f6ng\u00fcs\u00fcnde asenkron i\u015fleme yapmamak veya \u00e7ok uzun ve karma\u015f\u0131k handler zincirleri olu\u015fturmak gibi fakt\u00f6rler performans\u0131 olumsuz etkileyebilir. Asenkron i\u015flem ve dikkatli handler tasar\u0131m\u0131 ile bu sorunlar\u0131n \u00f6n\u00fcne ge\u00e7ilebilir.<\/p>\n 4. G\u00fcvenlik nas\u0131l sa\u011flan\u0131r?<\/strong><\/p>\n Botunuzun g\u00fcvenli\u011fi i\u00e7in \u00f6ncelikle bot token'\u0131n\u0131z\u0131 kesinlikle gizli tutmal\u0131s\u0131n\u0131z. API isteklerini HTTPS \u00fczerinden yapmal\u0131s\u0131n\u0131z. Ayr\u0131ca, kullan\u0131c\u0131 giri\u015flerini do\u011frulama ve yetkilendirme mekanizmalar\u0131 eklemelisiniz. \u00d6rne\u011fin, sadece belirli kullan\u0131c\u0131lar\u0131n hassas komutlar\u0131 kullanmas\u0131na izin veren handler'lar yazabilirsiniz. Veritaban\u0131 entegrasyonu yap\u0131yorsan\u0131z, SQL enjeksiyonu gibi sald\u0131r\u0131lara kar\u015f\u0131 dikkatli olmal\u0131 ve g\u00fcvenli veri depolama y\u00f6ntemleri kullanmal\u0131s\u0131n\u0131z<\/p>\n","protected":false},"excerpt":{"rendered":"Telegram Bot API, geli\u015ftiricilerin botlar\u0131n\u0131 Telegram platformuyla entegre etmelerini sa\u011flayan bir HTTP tabanl\u0131 aray\u00fczd\u00fcr. Botunuzun kullan\u0131c\u0131larla …","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1408],"tags":[],"class_list":{"0":"post-39172","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-java","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\nmessage<\/code>, edited_message<\/code>, callback_query<\/code>). En yayg\u0131n g\u00fcncelleme t\u00fcr\u00fc olan message<\/code> nesnesi, g\u00f6nderen, al\u0131c\u0131, metin, tarih gibi bilgileri i\u00e7erir.<\/p>\n\n{\n \"update_id\": 123456789,\n \"message\": {\n \"message_id\": 1,\n \"from\": {\n \"id\": 123456789,\n \"is_bot\": false,\n \"first_name\": \"Kullan\u0131c\u0131\",\n \"username\": \"kullanici_adi\"\n },\n \"chat\": {\n \"id\": 123456789,\n \"first_name\": \"Kullan\u0131c\u0131\",\n \"username\": \"kullanici_adi\",\n \"type\": \"private\"\n },\n \"date\": 1678886400,\n \"text\": \"\/start\"\n }\n}\n<\/pre>\nWebhook ve Long Polling<\/h4>\n
\n
Temel Bot Komutlar\u0131<\/h4>\n
\/start<\/code>, \/help<\/code> gibi komutlarla etkile\u015fime ba\u015flar. Bu komutlar, kullan\u0131c\u0131n\u0131n mesaj metninin ba\u015f\u0131nda bir e\u011fik \u00e7izgi (\/) ile ba\u015flayan \u00f6zel bir bi\u00e7ime sahip olmas\u0131yla tan\u0131n\u0131r. Botunuz, bu komutlar\u0131 ayr\u0131\u015ft\u0131rarak belirli i\u015flevleri tetikleyebilir.<\/p>\nNeden Kendi Minimal K\u00fct\u00fcphanemizi Yazmal\u0131y\u0131z?<\/h3>\n
Mevcut K\u00fct\u00fcphanelerin Dezavantajlar\u0131<\/h4>\n
Kontrol ve Esneklik<\/h4>\n
\u00d6\u011frenme ve Anlama S\u00fcreci<\/h4>\n
Performans ve Kaynak Kullan\u0131m\u0131<\/h4>\n
Handler Zinciri Deseni Nedir?<\/h3>\n
Desen Tan\u0131m\u0131 ve Amac\u0131<\/h4>\n
\u00c7al\u0131\u015fma Prensibi<\/h4>\n
\n
Avantajlar\u0131 ve Dezavantajlar\u0131<\/h4>\n
\n
\n
Telegram Bot Ba\u011flam\u0131nda Uygulanmas\u0131<\/h4>\n
\/start<\/code> komutunu i\u015flerken, di\u011feri \/help<\/code> komutunu i\u015fleyebilir. Bir ba\u015fka handler ise t\u00fcm metin mesajlar\u0131n\u0131 loglayabilir.<\/p>\nK\u00fct\u00fcphane Mimarisi ve Temel Bile\u015fenler<\/h3>\n
Update<\/code> ve Message<\/code> Modelleri<\/h4>\nUpdate<\/code> s\u0131n\u0131f\u0131 ve i\u00e7inde bir Message<\/code> s\u0131n\u0131f\u0131 olabilir.<\/p>\n\n\/\/ Update.java\npublic class Update {\n public long update_id;\n public Message message;\n \/\/ Di\u011fer update t\u00fcrleri i\u00e7in gerekli alanlar eklenebilir\n}\n\n\/\/ Message.java\npublic class Message {\n public long message_id;\n public User from;\n public Chat chat;\n public String text;\n \/\/ Di\u011fer mesaj t\u00fcrleri i\u00e7in gerekli alanlar eklenebilir\n}\n\n\/\/ User.java\npublic class User {\n public long id;\n public String first_name;\n public String username;\n}\n\n\/\/ Chat.java\npublic class Chat {\n public long id;\n public String type;\n public String first_name;\n public String username;\n}\n<\/pre>\nBotHandler<\/code> Aray\u00fcz\u00fc<\/h4>\nBotHandler<\/code> aray\u00fcz\u00fc, t\u00fcm somut handler'lar i\u00e7in ortak bir s\u00f6zle\u015fme tan\u0131mlar. Bu aray\u00fcz, bir g\u00fcncellemenin i\u015flenip i\u015flenemeyece\u011fini kontrol eden ve i\u015fleme mant\u0131\u011f\u0131n\u0131 i\u00e7eren metodlar\u0131 bar\u0131nd\u0131r\u0131r.<\/p>\n\n\/\/ BotHandler.java\npublic interface BotHandler {\n boolean handle(Update update, TelegramBot bot);\n void setNext(BotHandler nextHandler);\n BotHandler getNext();\n}\n<\/pre>\nhandle<\/code> metodu, bir g\u00fcncelleme nesnesini ve botun kendisini (cevap g\u00f6ndermek i\u00e7in) al\u0131r. E\u011fer handler g\u00fcncellemeyi i\u015flerse true<\/code> d\u00f6ner, aksi takdirde false<\/code> d\u00f6ner ve zincirdeki bir sonraki handler'a ge\u00e7ilmesi gerekti\u011fini belirtir. setNext<\/code> ve getNext<\/code> metodlar\u0131 ise zincir yap\u0131s\u0131n\u0131 kurmak i\u00e7in kullan\u0131l\u0131r.<\/p>\nHandlerChain<\/code> S\u0131n\u0131f\u0131<\/h4>\nHandlerChain<\/code> s\u0131n\u0131f\u0131, BotHandler<\/code> aray\u00fcz\u00fcn\u00fc uygulayan handler'lar\u0131 bir araya getiren ve gelen g\u00fcncellemeleri zincir boyunca ileten ana yap\u0131d\u0131r. Bu s\u0131n\u0131f, zincirin y\u00f6netiminden sorumludur.<\/p>\n\n\/\/ AbstractBotHandler.java (Temel bir soyut s\u0131n\u0131f)\npublic abstract class AbstractBotHandler implements BotHandler {\n protected BotHandler nextHandler;\n\n @Override\n public void setNext(BotHandler nextHandler) {\n this.nextHandler = nextHandler;\n }\n\n @Override\n public BotHandler getNext() {\n return nextHandler;\n }\n\n \/\/ handle metodu somut s\u0131n\u0131flarda uygulanacak\n}\n\n\/\/ HandlerChain.java\npublic class HandlerChain extends AbstractBotHandler {\n private BotHandler firstHandler;\n private BotHandler lastHandler;\n\n public HandlerChain() {\n this.firstHandler = null;\n this.lastHandler = null;\n }\n\n public void addHandler(BotHandler handler) {\n if (firstHandler == null) {\n firstHandler = handler;\n lastHandler = handler;\n } else {\n lastHandler.setNext(handler);\n lastHandler = handler;\n }\n }\n\n @Override\n public boolean handle(Update update, TelegramBot bot) {\n if (firstHandler != null) {\n return firstHandler.handle(update, bot);\n }\n return false; \/\/ Zincirde handler yoksa\n }\n}\n<\/pre>\nTelegramBot<\/code> S\u0131n\u0131f\u0131<\/h4>\nTelegramBot<\/code> s\u0131n\u0131f\u0131, botun ana kontrol noktas\u0131n\u0131 temsil eder. API isteklerini g\u00f6ndermek, g\u00fcncellemeleri almak ve HandlerChain<\/code>'i tetiklemek gibi g\u00f6revleri \u00fcstlenir. Bu s\u0131n\u0131f, bot token'\u0131n\u0131 tutar ve Telegram API ile ileti\u015fim kurmak i\u00e7in bir HTTP istemcisi kullan\u0131r.<\/p>\n\n\/\/ TelegramBot.java\npublic class TelegramBot {\n private final String botToken;\n private final String apiUrl;\n private final HttpClient httpClient;\n private final Gson gson;\n private final HandlerChain handlerChain;\n\n public TelegramBot(String botToken) {\n this.botToken = botToken;\n this.apiUrl = \"https:\/\/api.telegram.org\/bot\" + botToken + \"\/\";\n this.httpClient = HttpClient.newHttpClient();\n this.gson = new Gson();\n this.handlerChain = new HandlerChain();\n }\n\n public void addHandler(BotHandler handler) {\n handlerChain.addHandler(handler);\n }\n\n public void sendMessage(long chatId, String text) throws IOException, InterruptedException {\n String url = apiUrl + \"sendMessage\";\n MapHandler Zincirini Olu\u015fturma ve Y\u00f6netme<\/h3>\n
Temel
BotHandler<\/code> Uygulamalar\u0131<\/h4>\nBotHandler<\/code> uygulamalar\u0131 olu\u015fturabiliriz. Her biri, belirli bir sorumlulu\u011fa odaklanmal\u0131d\u0131r.<\/p>\n\n\/\/ StartCommandHandler.java\npublic class StartCommandHandler extends AbstractBotHandler {\n @Override\n public boolean handle(Update update, TelegramBot bot) {\n if (update.message != null && update.message.text != null && update.message.text.equals(\"\/start\")) {\n try {\n bot.sendMessage(update.message.chat.id, \"Merhaba! Botuma ho\u015f geldiniz.\");\n return true; \/\/ \u0130\u015flendi\n } catch (IOException | InterruptedException e) {\n e.printStackTrace();\n }\n }\n return nextHandler != null && nextHandler.handle(update, bot); \/\/ Bir sonrakine ilet\n }\n}\n\n\/\/ EchoTextHandler.java\npublic class EchoTextHandler extends AbstractBotHandler {\n @Override\n public boolean handle(Update update, TelegramBot bot) {\n if (update.message != null && update.message.text != null && !update.message.text.startsWith(\"\/\")) {\n try {\n bot.sendMessage(update.message.chat.id, \"Sen dedin ki: \" + update.message.text);\n return true; \/\/ \u0130\u015flendi\n } catch (IOException | InterruptedException e) {\n e.printStackTrace();\n }\n }\n return nextHandler != null && nextHandler.handle(update, bot); \/\/ Bir sonrakine ilet\n }\n}\n\n\/\/ UnknownCommandHandler.java (Zincirin sonu i\u00e7in)\npublic class UnknownCommandHandler extends AbstractBotHandler {\n @Override\n public boolean handle(Update update, TelegramBot bot) {\n if (update.message != null && update.message.text != null && update.message.text.startsWith(\"\/\")) {\n try {\n bot.sendMessage(update.message.chat.id, \"Bilinmeyen komut: \" + update.message.text);\n return true; \/\/ \u0130\u015flendi\n } catch (IOException | InterruptedException e) {\n e.printStackTrace();\n }\n }\n return false; \/\/ Zincirin sonu, i\u015flenmedi\n }\n}\n<\/pre>\nZincire Handler Ekleme<\/h4>\n
TelegramBot<\/code> s\u0131n\u0131f\u0131m\u0131z\u0131n addHandler<\/code> metodu arac\u0131l\u0131\u011f\u0131yla handler'lar\u0131 zincire ekleyebiliriz. Eklenme s\u0131ras\u0131 \u00f6nemlidir, \u00e7\u00fcnk\u00fc handler'lar bu s\u0131raya g\u00f6re i\u015flenir.<\/p>\n\npublic class MyBotApp {\n public static void main(String[] args) {\n String botToken = \"YOUR_BOT_TOKEN\"; \/\/ Bot token'\u0131n\u0131z\u0131 buraya girin\n TelegramBot bot = new TelegramBot(botToken);\n\n \/\/ Handler'lar\u0131 ekleme s\u0131ras\u0131 \u00f6nemlidir\n bot.addHandler(new StartCommandHandler());\n bot.addHandler(new EchoTextHandler());\n bot.addHandler(new UnknownCommandHandler()); \/\/ En sona eklenmeli\n \n \/\/ Botu ba\u015flatma kodu buraya gelecek\n }\n}\n<\/pre>\nHandler S\u0131ralamas\u0131 ve \u00d6ncelik<\/h4>\n
\/start<\/code> gibi belirli bir komutu i\u015fleyen handler, genel metin mesajlar\u0131n\u0131 i\u015fleyen handler'dan \u00f6nce gelmelidir. Aksi takdirde, \/start<\/code> komutu bir \"metin mesaj\u0131\" olarak alg\u0131lan\u0131p yanl\u0131\u015f handler taraf\u0131ndan i\u015flenebilir.<\/p>\nKo\u015fullu \u0130\u015fleme Mant\u0131\u011f\u0131<\/h4>\n
handle<\/code> metodu i\u00e7inde, gelen g\u00fcncellemeyi i\u015fleyip i\u015fleyemeyece\u011fine dair ko\u015fullu mant\u0131k bulunur. Bu mant\u0131k, mesaj\u0131n i\u00e7eri\u011fi, g\u00f6nderen ki\u015fi, sohbet t\u00fcr\u00fc gibi bir\u00e7ok fakt\u00f6re dayanabilir. E\u011fer bir handler g\u00fcncellemeyi i\u015flerse, genellikle true<\/code> d\u00f6nd\u00fcrerek zincirdeki di\u011fer handler'lar\u0131n i\u015fleme devam etmesini engeller. Bu, gereksiz i\u015flem y\u00fck\u00fcn\u00fc azalt\u0131r ve istenmeyen yan etkileri \u00f6nler.<\/p>\nBotu \u00c7al\u0131\u015ft\u0131rma ve Mesajlar\u0131 \u0130\u015fleme<\/h3>\n
G\u00fcncellemeleri \u00c7ekme (Long Polling)<\/h4>\n
\n\/\/ TelegramBot.java i\u00e7ine eklenecek metod\npublic void startLongPolling() {\n long lastUpdateId = 0;\n System.out.println(\"Bot ba\u015flat\u0131ld\u0131, g\u00fcncellemeler bekleniyor...\");\n\n while (true) {\n try {\n String url = apiUrl + \"getUpdates?offset=\" + (lastUpdateId + 1) + \"&timeout=30\";\n HttpRequest request = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .GET()\n .build();\n\n HttpResponseMyBotApp<\/code> s\u0131n\u0131f\u0131m\u0131zda bot.startLongPolling();<\/code> \u00e7a\u011fr\u0131s\u0131yla botu ba\u015flatabiliriz.<\/p>\nGelen Mesajlar\u0131 Ayr\u0131\u015ft\u0131rma<\/h4>\n
getUpdates<\/code> metodundan gelen JSON yan\u0131t\u0131n\u0131, \u00f6nceden tan\u0131mlad\u0131\u011f\u0131m\u0131z Update<\/code> ve Message<\/code> POJO'lar\u0131na d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in Gson veya Jackson gibi bir k\u00fct\u00fcphane kullan\u0131r\u0131z. Bu, Java kodumuzda mesaj verilerine kolayca eri\u015fmemizi sa\u011flar.<\/p>\nZinciri Tetikleme<\/h4>\n
TelegramBot<\/code> s\u0131n\u0131f\u0131ndaki processUpdate(Update update)<\/code> metodu \u00e7a\u011fr\u0131l\u0131r. Bu metod, gelen g\u00fcncellemeyi HandlerChain<\/code>'e iletir ve zincirdeki ilk handler'dan ba\u015flayarak i\u015fleme s\u00fcrecini ba\u015flat\u0131r.<\/p>\nCevap G\u00f6nderme Mekanizmas\u0131<\/h4>\n
TelegramBot<\/code> s\u0131n\u0131f\u0131nda tan\u0131mlad\u0131\u011f\u0131m\u0131z sendMessage(long chatId, String text)<\/code> metodu arac\u0131l\u0131\u011f\u0131yla yap\u0131l\u0131r. Bu metod, Telegram API'sinin sendMessage<\/code> metodunu \u00e7a\u011f\u0131rarak belirtilen sohbet kimli\u011fine mesaj g\u00f6nderir.<\/p>\nGeli\u015ftirmeyi Geni\u015fletme ve \u0130yile\u015ftirme<\/h3>\n
Asenkron \u0130\u015fleme<\/h4>\n
ExecutorService<\/code> veya CompletableFuture<\/code> yap\u0131lar\u0131 bu ama\u00e7la kullan\u0131labilir.<\/p>\n\n\/\/ TelegramBot.java i\u00e7inde\nprivate final ExecutorService executorService = Executors.newFixedThreadPool(10); \/\/ \u00d6rne\u011fin 10 i\u015f par\u00e7ac\u0131\u011f\u0131\n\npublic void processUpdateAsync(Update update) {\n executorService.submit(() -> handlerChain.handle(update, this));\n}\n\n\/\/ startLongPolling metodunda processUpdate yerine processUpdateAsync \u00e7a\u011fr\u0131l\u0131r.\n<\/pre>\nVeritaban\u0131 Entegrasyonu<\/h4>\n
Hata Y\u00f6netimi ve Loglama<\/h4>\n
Komut Tabanl\u0131 Handler'lar<\/h4>\n
\/start<\/code> gibi basit komutlar\u0131 de\u011fil, ayn\u0131 zamanda \/ayarlar dil T\u00fcrk\u00e7e<\/code> gibi arg\u00fcman alan komutlar\u0131 da i\u015fleyebilen daha geli\u015fmi\u015f komut ayr\u0131\u015ft\u0131rma handler'lar\u0131 olu\u015fturulabilir. Bu, komutlar\u0131 daha esnek hale getirir ve botun daha zengin etkile\u015fimler sunmas\u0131n\u0131 sa\u011flar.<\/p>\nSonu\u00e7<\/h3>\n
SSS (S\u0131k Sorulan Sorular)<\/h3>\n