sockpuppet

หุ่นเชิด

ซ็อกเก็ตและไลบรารีที่อยู่ C++ ที่เรียบง่ายและใช้งานง่าย

เกี่ยวกับ

คุณต้องการที่จะมีการสื่อสารผ่านเครือข่ายในโปรแกรมเล็ก ๆ ของคุณ แต่ดูเหมือนการเพิ่มประสิทธิภาพจะมากเกินไปใช่ไหม? และซ็อกเก็ตนี้จะยากแค่ไหนใช่มั้ย? - หลังจากที่อยู่ที่นั่นมากกว่าหนึ่งครั้ง ฉันเขียนห้องสมุดนี้ด้วยความหวังว่าจะช่วยฉันจากการเขียนโค้ดซ็อกเก็ตแบบใช้ครั้งเดียวแบบ half-assed ในอนาคต

คุณสมบัติของห้องสมุด

• รองรับระบบปฏิบัติการ Unix, OSX และ Windows
• การจัดการที่อยู่ IPv6 และ IPv4 (ค้นหาโดยใช้ getaddrinfo และที่เก็บข้อมูลโดยใช้ sockaddr_storage )
• multi-interface-aware (แสดงรายการที่อยู่อินเทอร์เฟซโฮสต์ในเครื่องก่อนเลือกที่อยู่ที่จะเชื่อมโยง)
• คลาสซ็อกเก็ต UDP และ TCP
• การออกอากาศ UDP (แต่ไม่ใช่โดยอัตโนมัติบนอินเทอร์เฟซเครือข่ายหลาย ๆ อัน)
• ซ็อกเก็ตพื้นฐานที่มีการปิดกั้นและไม่ปิดกั้น IO โดยใช้พารามิเตอร์การหมดเวลาทางเลือก
• ซ็อกเก็ตแบบขยายพร้อมพูลทรัพยากรภายในที่กำหนดค่าได้ ซึ่งช่วยลดความจำเป็นในการบัฟเฟอร์ที่จัดสรรไว้ล่วงหน้า
• ซ็อกเก็ตขยายสำหรับการทำงานแบบอะซิงโครนัสโดยใช้อินเทอร์เฟซเธรดไดรเวอร์ (การจัดการเหตุการณ์โดยใช้ การสำรวจความคิดเห็น )
• ซ็อกเก็ต TCP สามารถเพิ่มได้ด้วยการเข้ารหัส TLS
• งานที่กำหนดเวลาไว้ให้รัน ณ จุดที่กำหนดโดยเธรดไดรเวอร์
• ข้อยกเว้นที่มีข้อความแสดงข้อผิดพลาดที่ระบบให้มาซึ่งมีความหมาย
• ไลบรารีรวมถึงอย่าดึงระบบหรือส่วนหัวภายนอกใด ๆ
• เป้าหมายการสร้างไลบรารีแบบคงที่และไดนามิก
• การทดสอบการทำงานบางอย่าง
• รวมตัวอย่างและโครงการสาธิต
• การทดสอบหน่วยที่ละเอียดถี่ถ้วน ?
• UDP มัลติคาสต์
• เลขคณิตที่อยู่ / ค้นหาที่อยู่เครือข่าย / การออกอากาศ

สร้าง

กำหนดค่าและสร้างไลบรารี/ตัวอย่าง/สาธิต/ทดสอบโดยใช้ CMake

เริ่มต้นอย่างรวดเร็ว

เป้าหมายการติดตั้ง CMake เตรียมโครงการสาธิตที่ใช้ CMake ซึ่งเหมาะสมเป็นจุดเริ่มต้นสำหรับแอปพลิเคชันของตัวเอง

อินเตอร์เฟซห้องสมุด

คลาส Address แสดงถึง localhost หรือที่อยู่ UDP/TCP ระยะไกล และใช้เพื่อสร้างภายในเครื่องและส่ง/เชื่อมต่อกับซ็อกเก็ตระยะไกล

คลาสซ็อกเก็ต Socket* , Socket*Buffered และ Socket*Async ให้ระดับความสะดวกสบายที่แตกต่างกันเกี่ยวกับการแสดงซ็อกเก็ตระบบปฏิบัติการดิบ:

• SocketUdp และ SocketTcp อนุญาตให้ใช้ฟังก์ชันพื้นฐาน เช่น เชื่อมต่อ ส่ง และรับ ในขณะที่ Acceptor ฟังสำหรับการเชื่อมต่อ TCP ขาเข้า
• SocketUdpBuffered และ SocketTcpBuffered เพิ่มพูลบัฟเฟอร์การรับภายใน
• SocketUdpAsync และ SocketTcpAsync รวมถึง AcceptorAsync ทำงานโดย Driver (เช่น เธรด) ซึ่งให้การดำเนินการแบบอะซิงโครนัสกับซ็อกเก็ตหนึ่งหรือหลายซ็อกเก็ต

หากสร้างด้วยการสนับสนุน TLS คลาสซ็อกเก็ต TCP ทั้งหมดสามารถสร้างอินสแตนซ์ด้วยใบรับรอง SSL และไฟล์คีย์ส่วนตัวเพื่อเรียกใช้การเชื่อมต่อที่เข้ารหัส

คลาส ToDo ใช้สำหรับการจัดตารางเวลางานให้ Driver รัน ณ จุดเวลาที่กำหนด เช่น การส่งแพ็กเก็ตฮาร์ทบีทเป็นระยะ ๆ หรือพยายามเชื่อมต่อใหม่

เหตุผลในการออกแบบ

• คลาสที่ผู้ใช้มองเห็นได้ส่วนใหญ่ใช้รูปแบบบริดจ์/PIMPL เพื่อหลีกเลี่ยงการส่งต่อส่วนหัวของระบบที่รวมไว้ภายใน
• คลาสที่อยู่ใช้ getaddrinfo เมื่อสร้างโดยอินพุตของผู้ใช้และ sockaddr_storage เมื่อสร้างโดยซ็อกเก็ต สำหรับผู้ใช้ ความแตกต่างนี้มีความโปร่งใส
• ในขณะที่คลาสซ็อกเก็ตที่ผู้ใช้มองเห็นจะแยกความแตกต่างระหว่าง UDP/TCP แต่คลาสซ็อกเก็ต PIMPL จะมีฟังก์ชันทั่วไปที่อาจมีความซ้ำซ้อนสำหรับกรณีการใช้งานบางกรณี
• โพล ถูกใช้ก่อนซ็อกเก็ต IO หากมีการหมดเวลาอย่างจำกัด เพื่อเป็นเกียรติแก่กำหนดเวลา
• ซ็อกเก็ตเสริมใช้ซ็อกเก็ตพื้นฐานที่สร้างไว้ล่วงหน้าเพื่อหลีกเลี่ยงการรวมอาร์กิวเมนต์ตัวสร้างซ็อกเก็ตฐานทั้งหมดและช่องทางข้อยกเว้นทั้งหมด
• เธรดไม่ได้ถูกสร้างขึ้นภายในเพื่อหลีกเลี่ยงการปิดระบบไลบรารี่ที่ใช้ร่วมกันที่ยุ่งเหยิงบน Windows