jackson
1.0.0
นี่คือหน้าแรกของโครงการแจ็คสัน
(หมายเหตุ: สำหรับข้อมูลการเปิดตัวที่ทันสมัยดู Jackson Reases)
แจ็คสันเป็นที่รู้จักในฐานะ "The Java Json Library" หรือ "ตัวแยกวิเคราะห์ JSON ที่ดีที่สุดสำหรับ Java" หรือเพียงแค่ "JSON สำหรับ Java"
ยิ่งไปกว่านั้นแจ็คสันเป็นชุดเครื่องมือประมวลผลข้อมูลสำหรับ Java (และแพลตฟอร์ม JVM) รวมถึงห้องสมุด JSON Parser / Generator JONSHION, การจับคู่ห้องสมุดที่จับกับข้อมูล (pojos ไปและกลับจาก JSON) และโมดูลรูปแบบข้อมูลเพิ่มเติม Yaml; และแม้แต่ชุดรูปแบบข้อมูลขนาดใหญ่เพื่อรองรับประเภทข้อมูลของประเภทข้อมูลที่ใช้กันอย่างแพร่หลายเช่น Guava, Joda, PCOLLECTIONS และอีกมากมายอีกมากมาย (ดูด้านล่าง)
ในขณะที่องค์ประกอบหลักที่แท้จริงอาศัยอยู่ภายใต้โครงการของตนเอง - รวมถึงแพ็คเกจหลักสามชุด (สตรีมมิ่ง, ดาต้าบิน, คำอธิบายประกอบ); ไลบรารีรูปแบบข้อมูล ไลบรารีประเภทข้อมูล ผู้ให้บริการ JAX-RS; และชุดเบ็ดเตล็ดของโมดูลส่วนขยายอื่น ๆ - โครงการนี้ทำหน้าที่เป็นศูนย์กลางกลางสำหรับการเชื่อมโยงชิ้นส่วนทั้งหมดเข้าด้วยกัน
เพื่อนที่ดีสำหรับผู้อ่านนี้คือคำถามที่พบบ่อยของ Jackson Project
Jackson Suite มีสองเวอร์ชันหลัก: 1.x เลิกใช้แล้วและไม่มีการปล่อยเวอร์ชัน 2.x เป็นเวอร์ชันที่พัฒนาขึ้นอย่างแข็งขัน ทั้งสองรุ่นหลักนี้ใช้แพ็คเกจ Java ที่แตกต่างกันและ Maven Artifact IDs ดังนั้นพวกเขาจึงไม่สามารถใช้งานร่วมกันได้ แต่สามารถอยู่ร่วมกันได้อย่างสงบสุข: โครงการสามารถขึ้นอยู่กับทั้ง Jackson 1.x และ 2.x โดยไม่มีความขัดแย้ง นี่คือการออกแบบและได้รับเลือกให้เป็นกลยุทธ์เพื่อให้การย้ายถิ่นที่ราบรื่นยิ่งขึ้นจาก 1.x ถึง 2.x
รุ่นที่มั่นคงล่าสุดจากสาขาเหล่านี้คือ:
วิธีที่แนะนำในการใช้แจ็คสันคือผ่านที่เก็บ Maven; การเผยแพร่จะถูกสร้างขึ้นไปยังที่เก็บ Maven Central (CMR) บางครั้งหน้า Wiki ของแต่ละโครงการยังมีลิงก์ดาวน์โหลดโดยตรงชี้ไปที่ CMR
บันทึกย่อสำหรับการเปิดตัว 2.x พบได้จากหน้า Jackson Reasees
โครงการส่วนใหญ่ที่ระบุไว้ด้านล่างนี้นำโดยทีมพัฒนาแจ็คสัน; แต่บางคนโดยสมาชิกชุมชนแจ็กสันรายใหญ่คนอื่น ๆ เราพยายามที่จะทำให้โมดูลของโมดูลเข้ากันได้เพื่อลดความสับสนเกี่ยวกับเวอร์ชันใดที่ทำงานร่วมกัน
โมดูลหลักเป็นรากฐานที่ส่วนขยาย (โมดูล) สร้างขึ้น ปัจจุบันมี 3 โมดูลดังกล่าว (ณ Jackson 2.x):
streaming ; ขึ้นอยู่กับทั้งแพ็คเกจ streaming และ annotations ส่วนขยายเหล่า ObjectWriter คือปลั๊กอิน ObjectMapper ObjectReader สัน Module S (ลงทะเบียนกับ ObjectMapper.registerModule() ) และเพิ่มการสนับสนุนสำหรับประเภทข้อมูลของไลบรารี Java ที่ใช้กันทั่วไปโดยการเพิ่ม serializers และ deserializers เพื่อให้แพ็คเกจ databind Jackson
โมดูลข้อมูลที่ดูแลโดยตรงโดยทีมงานแจ็คสันอยู่ภายใต้ที่เก็บ GitHub ต่อไปนี้:
jackson-module-parameter-names : โมดูลที่เพิ่มการสนับสนุนสำหรับการใช้คุณสมบัติ JDK8 ใหม่ความสามารถในการเข้าถึงชื่อของตัวสร้างและพารามิเตอร์เมธอดเพื่ออนุญาตให้ละเว้น @JsonPropertyjackson-datatype-jsr310 : สนับสนุน "Java 8 Dates" (เพิ่มใน JDK 8)jackson-datatype-jdk8 : สนับสนุนประเภทข้อมูล JDK 8 นอกเหนือจากประเภทวันที่/เวลารวมถึง OptionalMoney , CurrencyUnit )javax.json ) และ "ใหม่" ( jakarta.json ):jakarta.json ( เพิ่มในแจ็คสัน 2.12.2 )javax.jsonJSONObject , JSONArrayนอกจากนี้เราตระหนักถึงโมดูลเพิ่มเติมที่ไม่ได้รับการดูแลโดยตรงจากทีม Core Jackson:
jackson-dataformat-protobuf ซึ่งเพิ่มการสนับสนุนสำหรับการเข้ารหัส/ถอดรหัสเนื้อหา protobuf แต่ไม่ได้ขึ้นอยู่กับไลบรารี Java protobuf มาตรฐานมาตรฐานcom.github.caligin.tinytypes , สิ่งประดิษฐ์ tinytypes-jackson )org.vertx.java.core.json.JsonObject วัตถุ (repackaged org.json ประเภทโหนด) ผู้ให้บริการ Jackson JAX-RS มีตัวจัดการเพื่อเพิ่มการสนับสนุน DataFormat สำหรับการใช้งาน JAX-RS (เช่น Jersey, Resteasy, CXF) ผู้ให้บริการใช้ MessageBodyReader และ MessageBodyWriter รูปแบบที่ได้รับการสนับสนุนในปัจจุบัน ได้แก่ JSON , Smile , XML , YAML และ CBOR
โมดูลรูปแบบข้อมูลให้การสนับสนุนรูปแบบข้อมูลอื่นนอกเหนือจาก JSON พวกเขาส่วนใหญ่ใช้ streaming API abstractions เพื่อให้สามารถใช้ส่วนประกอบ databinding ตาม IS; ข้อเสนอบางอย่าง (และไม่กี่ต้องการ) ฟังก์ชั่นระดับ databind เพิ่มเติมสำหรับการจัดการสิ่งต่าง ๆ เช่น schemas
ขณะนี้โมดูลรูปแบบข้อมูลสามารถใช้งานได้อย่างสมบูรณ์และรองรับ (หมายเลขเวอร์ชันในวงเล็บหากรวมเป็นเวอร์ชัน Jackson 2.x รุ่นแรกที่รวมโมดูลถ้าหายไปรวมจาก 2.0)
streaming บวกกับการสนับสนุน databind -ระดับเพิ่มเติมสำหรับ Avro Schemasstreaming API พร้อมการเพิ่ม databind ความสะดวกสบายเสริมAvrostreaming API ไม่มีการเปลี่ยนแปลงสำหรับ databindstreaming และการใช้งาน databindstreaming และการใช้งาน databind คล้ายกับโหมด "รหัสแรก" ของ Jaxb (ไม่สนับสนุนสำหรับ "XML Schema First" แต่สามารถใช้ Jaxb Beans ได้)streaming แบบง่าย ๆนอกจากนี้ยังมีโมดูลรูปแบบข้อมูลอื่น ๆ ซึ่งจัดทำโดยนักพัฒนานอกทีม Jackson Core:
MsgPack )คำอธิบายประกอบของแจ็คสันกำหนดคุณสมบัติที่ตั้งใจไว้และการจัดการที่คาดหวังสำหรับ POJOS และนอกเหนือจากแจ็คสันเองโดยใช้สิ่งนี้สำหรับการอ่าน/การเขียน JSON และรูปแบบอื่น ๆ แล้วยังช่วยให้การสร้าง schemas ภายนอก ฟังก์ชั่นบางอย่างนี้รวมอยู่ในส่วนขยายรูปแบบข้อมูลที่กล่าวถึงข้างต้น แต่ยังมีเครื่องมือสคีมาแบบสแตนด์อโลนมากมายเช่น:
โมดูลอื่น ๆ ที่ใช้งานได้อย่างสมบูรณ์โดยทีม FasterXML รวมถึง:
@JacksonInject มาตรฐาน (หรือนอกเหนือจาก)JAXB เป็นทางเลือก (นอกเหนือจากหรือแทนที่จะเป็น) คำอธิบายประกอบมาตรฐานแจ็คสัน@JacksonInject Annotation@JsonPropertyในขณะที่ Jackson Databind เป็นตัวเลือกที่ดีสำหรับการเชื่อมโยงข้อมูลที่มีวัตถุประสงค์ทั่วไป แต่ค่าใช้จ่ายและค่าใช้จ่ายในการเริ่มต้นอาจเป็นปัญหาในบางโดเมนเช่นโทรศัพท์มือถือ และโดยเฉพาะอย่างยิ่งสำหรับการใช้งานแสง (สองสามอ่านหรือเขียน) นอกจากนี้นักพัฒนาบางคนพบ Jackson API เต็มรูปแบบ
ด้วยเหตุผลทั้งหมดเหล่านี้เราตัดสินใจที่จะสร้างห้องสมุดขนาดเล็กที่ง่ายกว่าซึ่งรองรับชุดย่อยของฟังก์ชั่นที่เรียกว่า Jackson JR มันสร้างขึ้นบน Jackson Streaming API แต่ไม่ได้ขึ้นอยู่กับ Databind เป็นผลให้ขนาดของมัน (ทั้งขวดและการใช้หน่วยความจำรันไทม์) มีขนาดเล็กลงมาก และ API ของมันมีขนาดกะทัดรัดมาก
หากคุณต้องการช่วยโครงการแจ็คสันโปรดตรวจสอบการบริจาค
คุณอาจต้องการตรวจสอบ:
ส่วนประกอบของแจ็คสันได้รับการสนับสนุนโดยชุมชนแจ็คสันผ่านรายการส่งจดหมาย, ฟอรัม Gitter, ปัญหา GitHub ดูรายละเอียดทั้งหมด
นอกเหนือจากการสนับสนุนชุมชนฟรี (สำหรับทุกคน) การสนับสนุนระดับองค์กร - เริ่มต้นด้วยเวอร์ชัน 2.10 ซึ่งเป็นส่วนหนึ่งของการสมัครสมาชิก TideLift สำหรับส่วนประกอบแจ็คสัน (ส่วนใหญ่)
ผู้ดูแลของ Jackson และแพ็คเกจอื่น ๆ อีกหลายพันชุดกำลังทำงานร่วมกับ TideLift เพื่อให้การสนับสนุนเชิงพาณิชย์และการบำรุงรักษาสำหรับการพึ่งพาโอเพ่นซอร์สที่คุณใช้เพื่อสร้างแอปพลิเคชันของคุณ ประหยัดเวลาลดความเสี่ยงและปรับปรุงสุขภาพของรหัสในขณะที่จ่ายค่ารักษาผู้ดูแลการพึ่งพาที่แน่นอนที่คุณใช้ เรียนรู้เพิ่มเติม
กลไกที่แนะนำสำหรับการรายงานช่องโหว่ความปลอดภัยที่เป็นไปได้ดังต่อไปนี้เรียกว่า "แผนการเปิดเผยข้อมูลประสานงาน" (ดูคำจำกัดความของ DCP สำหรับแนวคิดทั่วไป) ขั้นตอนแรกคือการยื่นติดต่อ TideLift Security Contact: TideLift จะกำหนดเส้นทางรายงานทั้งหมดผ่านระบบของพวกเขาไปยังผู้ดูแลแพ็คเกจที่เกี่ยวข้องและเริ่มกระบวนการที่จะประเมินข้อกังวลและการแก้ไขปัญหาที่เป็นไปได้ส่งประกาศการอัปเดตและอื่น ๆ โปรดทราบว่าคุณไม่จำเป็นต้องเป็นสมาชิก TideLift เพื่อยื่นติดต่อผู้ติดต่อด้านความปลอดภัย
หรือคุณอาจรายงานช่องโหว่ที่อาจเกิดขึ้นกับ info ที่ที่อยู่ fasterxml dot com โปรดทราบว่าการยื่นปัญหาเพื่อไปกับรายงานนั้นใช้ได้ แต่ถ้าคุณทำเช่นนั้นโปรดไม่รวมรายละเอียดของปัญหาความปลอดภัยในปัญหา แต่เฉพาะในการติดต่อทางอีเมล นี่เป็นสิ่งสำคัญที่จะให้เวลากับเราในการให้แพตช์หากจำเป็นสำหรับปัญหา
ต้องมีการรายงานข้อบกพร่องของแจ็คสันกับส่วนประกอบที่มีผลกระทบ: ด้วยเหตุผลนี้จึงไม่ได้เปิดใช้งานตัวติดตามปัญหาสำหรับโครงการนี้ หากคุณไม่แน่ใจว่าปัญหาโครงการใดที่มีผลกระทบใดส่วนประกอบที่เป็นไปได้มากที่สุดคือ jackson-databind ดังนั้นคุณจะใช้ Jackson Databind ปัญหาตัวติดตาม
สำหรับคำแนะนำและแนวคิดใหม่ลองใช้ความคิดในอนาคตของแจ็คสัน
สำหรับผู้ใช้ครั้งแรกมีบทช่วยสอนการใช้งานแจ็คสันที่ดีมากมายรวมถึงการใช้งานทั่วไป / บทช่วยสอน JSON:
และแบบฝึกหัดที่เฉพาะเจาะจงมากขึ้น:
รายงานต่อไปนี้ได้รับการเผยแพร่เกี่ยวกับองค์ประกอบของแจ็คสัน
เนื่องจากคุณอาจต้องการความคิดเห็นจากนักพัฒนา Java ที่ไม่เกี่ยวข้องกับ Jackson Project เกี่ยวกับห้องสมุดที่จะใช้นี่คือลิงค์ไปยังการเปรียบเทียบอิสระที่มีอยู่บางส่วน:
