Activiti

กิจกรรม

หน้าแรก: http://activiti.org

Activiti เป็นเวิร์กโฟลว์น้ำหนักเบาและแพลตฟอร์มการจัดการกระบวนการทางธุรกิจ (BPM) ที่กำหนดเป้าหมายไปที่นักธุรกิจ นักพัฒนา และผู้ดูแลระบบ แกนหลักของมันคือเอ็นจิ้นกระบวนการ BPMN 2 ที่รวดเร็วและแข็งแกร่งสำหรับ Java เป็นโอเพ่นซอร์สและเผยแพร่ภายใต้ลิขสิทธิ์ Apache Activiti ทำงานในแอปพลิเคชัน Java บนเซิร์ฟเวอร์ บนคลัสเตอร์ หรือในระบบคลาวด์ เข้ากันได้อย่างลงตัวกับสปริง โดยมีน้ำหนักเบาเป็นพิเศษและมีพื้นฐานมาจากแนวคิดที่เรียบง่าย

* *หมายเหตุ: เราย้ายเนื้อหาทั้งหมดของสาขาการพัฒนาที่เราใช้ในการออกแบบและเขียนโค้ดเวอร์ชันหลักถัดไปของโครงการไปยังสาขาหลัก หากคุณต้องการสนับสนุนเวอร์ชัน 6.x โปรดดูที่สาขา 6.x**

หากคุณต้องการอ่านเพิ่มเติมเกี่ยวกับโครงสร้าง Repositories ของเรา คุณสามารถอ่าน GitBook ของเราได้

การกำหนดค่า IntelliJ

• บังคับให้ภาษาระดับ 21 ล้มเหลวอย่างรวดเร็วเมื่อ (โดยบังเอิญ) ใช้คุณสมบัติที่มีให้เฉพาะในเวอร์ชัน Java ที่ใหม่กว่าเท่านั้น

  • เปิดเมนู ไฟล์ รายการเมนู โครงสร้างโครงการ
  • คลิกรายการ Modules สำหรับแต่ละโมดูล แท็บ Sources ระดับภาษา คอมโบบ็อกซ์ควรตั้งค่าเป็น 21 ...

• หลีกเลี่ยงไม่ให้การเปลี่ยนแปลงในทรัพยากรบางอย่างถูกละเว้นในการรัน/ดีบักครั้งถัดไป (และคุณถูกบังคับให้ใช้ mvn)

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิกรายการต้นไม้ Compiler , ช่องข้อความ รูปแบบทรัพยากร : เปลี่ยนเป็น !?*.java (ลบเนื้อหาอื่น ๆ )

• หลีกเลี่ยง StackOverflowError เมื่อสร้าง

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิกรายการแผนผัง Compiler รายการแผนผัง Java Compiler ฟิลด์ข้อความ พารามิเตอร์ บรรทัดคำสั่งเพิ่มเติม
  • เพิ่ม -J-Xss1024k

• รูปแบบโค้ดที่แนะนำ: ใช้คู่มือสไตล์ Google Java พร้อม editorconfig

  • ดาวน์โหลด xml สไตล์โค้ด IntelliJ จาก: [https://google.github.io/styleguide/intellij-java-google-style.xml]
  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิกรายการต้นไม้ Code Style คลิกล้อเฟืองและเลือก Import Scheme จากนั้นเลือก IntelliJ code style xml
  • เรียกดูตำแหน่งที่คุณดาวน์โหลด xml แล้วเปิดขึ้นมา ตรวจสอบว่า GoogleStyle เป็นรูปแบบที่ใช้งานอยู่
    • หมายเหตุ: IntelliJ IDEA จะไม่จัดรูปแบบโค้ดของคุณโดยอัตโนมัติ คุณต้องกดแป้นพิมพ์ Ctrl+Alt+L เพื่อทริกเกอร์การจัดรูปแบบอัตโนมัติเมื่อเขียนโค้ดเสร็จแล้ว
  • มี .editorconfig ซึ่งมีคำจำกัดความของการเยื้อง การเข้ารหัสไฟล์ การลงท้ายบรรทัด
  • หากคุณปิดใช้งาน คุณจะต้องตั้งค่าการเข้ารหัสไฟล์และจำนวนช่องว่างด้วยตนเองอย่างถูกต้อง
  • รูปแบบโค้ด Eclipse xml: [https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • Eclipse ต้องการปลั๊กอิน editorconfig-eclipse เพื่อรองรับไฟล์ EditorConfig

• ตั้งค่าการเข้ารหัสไฟล์ที่ถูกต้องด้วยตนเอง (UTF-8 ยกเว้นไฟล์คุณสมบัติ) และอักขระท้ายบรรทัด (ยูนิกซ์):

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิก ลักษณะรหัส รายการต้นไม้ รายการต้นไม้ ทั่วไป
    • Combobox Line separator (สำหรับไฟล์ใหม่) : Unix
  • คลิกรายการแผนผัง การเข้ารหัสไฟล์
    • การเข้ารหัสสากล Combobox : UTF-8
    • Combobox การเข้ารหัสเริ่มต้นสำหรับไฟล์คุณสมบัติ : ISO-8859-1
      • หมายเหตุ: ไฟล์คุณสมบัติ i18n ปกติต้องอยู่ใน ISO-8859-1 ตามที่ระบุโดยสัญญา java ResourceBundle

• ตั้งค่าจำนวนช่องว่างที่ถูกต้องด้วยตนเองเมื่อกดแท็บ:

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิก ลักษณะรหัส รายการต้นไม้ รายการต้นไม้ ทั่วไป
  • คลิกแท็บ Java
    • ช่องทำ เครื่องหมายใช้อักขระแท็บ : off
    • ขนาดแท็บ ช่องข้อความ : 4
    • เยื้อง ช่องข้อความ : 4
    • เยื้องต่อเนื่อง ของฟิลด์ข้อความ : 8
  • เปิดแท็บ XML
    • ช่องทำ เครื่องหมายใช้อักขระแท็บ : off
    • ขนาดแท็บ ฟิลด์ข้อความ : 2
    • เยื้อง ช่องข้อความ : 2
    • เยื้องการต่อเนื่อง ของฟิลด์ข้อความ: 4

• ตั้งค่าส่วนหัวของไฟล์ที่ถูกต้อง (ไม่รวม @author หรือ javadoc ที่ไม่มีความหมาย):

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิกรายการต้นไม้ เทมเพลตไฟล์ แท็บ รวม รายการ File Header
  • ลบบรรทัด @author ชื่อของคุณ .
    • เราไม่ยอมรับบรรทัด @author ในไฟล์ต้นฉบับ ดูคำถามที่พบบ่อยด้านล่าง
  • ลบ javadoc ทั้งหมด เนื่องจากข้อมูลที่สร้างเทมเพลตโดยอัตโนมัติไม่มีความหมาย

• ตั้งค่าส่วนหัวใบอนุญาตที่ถูกต้อง

  • เปิดเมนู File รายการเมนู การตั้งค่า หรือเมนู IntelliJ IDEA รายการเมนู การตั้งค่า... ถ้าบน Mac
  • คลิก รายการต้นไม้ ลิขสิทธิ์ รายการต้นไม้ โปรไฟล์ลิขสิทธิ์
    • คลิกปุ่มนำเข้าเพื่อนำเข้า โปรไฟล์ลิขสิทธิ์
    • เลือกไฟล์: Alfresco_Software.xml
  • คลิกรายการต้นไม้ ลิขสิทธิ์
    • Combobox ลิขสิทธิ์โครงการเริ่มต้น : Alfresco Software

คำถามที่พบบ่อย

• ทำไมคุณไม่ยอมรับบรรทัด @author ในซอร์สโค้ดของคุณ

  • เนื่องจากแท็กผู้เขียนในไฟล์ java ถือเป็นฝันร้ายในการบำรุงรักษา

    • เปอร์เซ็นต์ที่ไม่ถูกต้อง ไม่สมบูรณ์ หรือไม่ถูกต้อง
    • โดยส่วนใหญ่แล้วจะมีเพียงผู้เขียนต้นฉบับเท่านั้น ไฟล์จำนวนมากได้รับการปรับโครงสร้าง/ขยายใหม่ทั้งหมดโดยผู้เขียนคนอื่นๆ
    • Git นั้นแม่นยำ นั่นคือแหล่งที่มาของ Canonical ในการค้นหาผู้เขียนที่ถูกต้อง

  • เนื่องจากแท็กผู้เขียนส่งเสริม การเป็นเจ้าของโค้ด ซึ่งส่งผลเสียในระยะยาว

    • หากผู้คนทำงานชิ้นที่พวกเขามองว่าเป็นของคนอื่น พวกเขามักจะ:
      • แก้ไขเฉพาะสิ่งที่พวกเขามอบหมายให้แก้ไข แทนที่จะแก้ไขทุกอย่างที่เสียหาย
      • ละทิ้งความรับผิดชอบหากรหัสนั้นทำงานไม่ถูกต้อง
      • กลัวเหยียบเท้าเจ้าของ

  • ให้เครดิตแก่ผู้เขียน:

    • ด้วย Open Hub ซึ่งมีสถิติด้วย
    • ในเว็บอินเตอร์เฟส GitHub

คำสั่งพัฒนา

เพิ่มส่วนหัวใบอนุญาต

หากต้องการจัดรูปแบบไฟล์ด้วยใบอนุญาตที่จำเป็น:

mvn license:format

เช็คสไตล์

วิธีตรวจสอบว่าสไตล์โค้ดของคุณเป็นไปตามกฎทั้งหมดหรือไม่:

mvn checkstyle:check -DskipCheckstyle=false

เว็บไซต์

ในการสร้างไซต์ Maven:

mvn clean site site:stage

ไซต์จะถูกสร้างขึ้นที่: target/staging/index.html

ซีไอ/ซีดี

ทำงานบนการกระทำของ GH

เพื่อให้ Dependabot PR ได้รับการตรวจสอบโดย CI ควรเพิ่มป้ายกำกับ "CI" ใน PR

ต้องตั้งค่าข้อมูลลับต่อไปนี้:

ชื่อ	คำอธิบาย
BOT_GITHUB_TOKEN	โทเค็นเพื่อเปิดตัวงานสร้างอื่น ๆ บน GH
BOT_GITHUB_USERNAME	ชื่อผู้ใช้ในการออกประชาสัมพันธ์เผยแพร่
NEXUS_USERNAME	ชื่อผู้ใช้ที่เก็บ Maven ภายใน
NEXUS_PASSWORD	รหัสผ่านที่เก็บ Maven ภายใน
SLACK_NOTIFICATION_BOT_TOKEN	โทเค็นเพื่อแจ้งเตือนการหย่อนเมื่อเกิดความล้มเหลว