3.12調度功能的使用與開發深圳市信息職業技術學院目

錄調度功能介紹01調度界面配置說明02調度功能開發示例03常見異常問題列舉04知識回顧接口介紹；Api接口的定義；Api接口的開發與測試；Api接口的調用。學習目標通過本節學習可以：掌握調度任務的配置；掌握調度參數類的開發實現；掌握調度任務類的開發實現；了解調度常見問題；01調度功能介紹調度功能介紹調度功能介紹調度：是指根據一定的策略和算法，按照預定的規則和優先級，安排任務或資源的執行順序和時間分配的過程。工業管理軟件的調度任務是指系統按配置要求，定時執行相關的任務，這里分別有兩個方面，一個是要執行的任務，需要開發人員使用代碼實現相關的業務邏輯，另一個是實施人員在系統中配置執行任務的時間、周期、參數等。使用調度的功能，如果是直連數據庫調試，需要在WebClient工程中引用Hangfire.Oracle.Core.dll，SIE.Schedule.dll和SIE.Web.Schedule.dll，依賴的第三方包：Hangfire1.7.8，Hangfire.Core1.7.8。調度的數據庫連接名：hangfire；VS自帶的數據庫連接配置"hangfire":{"Name":"hangfire","ConnectionString":"DataSource=(LocalDB)\\MSSQLLocalDB;AttachDbFilename=D:\\Project\\DEMO\\SMOM.Demo.V9.1\\App_Data\\DEMO_91.mdf;IntegratedSecurity=True;UserId=DEMO_91","ProviderName":"System.Data.SqlClient"},調度功能介紹調度功能介紹調度功能的開發，最好是與業務工程區分開，單獨建調度工程進行調度功能的開發，工程名以Job結尾。命名規范：調度任務類命名以Job結尾；調度參數類命名以JobParameter結尾。做調度功能開發時，調度任務類是必須的，調度參數類非必須(根據具體的業務來決定是否需要參數類)。做調度功能開發時，日志必須記錄詳細。02調度界面配置說明調度界面配置調度界面配置調度的界面配置都是在“調度任務設置”功能配置完成的。調度界面配置調度界面配置在“調度任務設置”功能中添加調度任務，選擇一筆數據，點擊確定。調度界面配置調度界面配置調度名稱可以修改，配置cron表達式和方法參數。調度界面配置調度界面配置配置調度任務參數（執行時間和周期）點擊調度任務的“cron表達式”，可配置調度任務的執行時間及周期，即告訴調度器什么時候執行，或者隔多久執行一次。調度界面配置調度界面配置配置調度任務的參數（業務參數）點擊調度任務的“方法參數”，即可彈出該任務的業務參數配置頁面，該頁面就是由調度任務參數視圖進行配置的。調度界面配置調度界面配置配置完成后，保存數據，任務狀態默認是可用的。調度界面配置調度界面配置運行和觸發啟動后點擊觸發按鈕，進入調度任務排隊等待，根據時間先后順序執行。運行和觸發的區別：運行：表示立即執行，在本地環境運行調度，在開發時可通過這個按鈕進行調試調度任務。觸發：進入排隊等待，在調度服務運行，由調度器執行。觸發依賴于調度服務，本地調試配置了cron表達式，點擊觸發，也不會定時去執行調度任務；在調度服務執行調度任務時，任務狀態必須是啟用的才會進行排隊等待執行。思考題調度任務配置為每天的16點執行，該如何配置？03調度功能開發示例調度功能開發示例需求描述需求描述：開發一個調度任務，根據類別名稱、狀態來統計讀者數量（類別名稱和狀態作為參數傳入）。思考題上頁PPT中，要實現需求描述的要求的調度任務，至少需要開發幾個類？調度功能開發示例開發步驟開發調度參數類，命名以JobParameter結尾，標記特性根實體和序列化[RootEntity,Serializable]，繼承JobParameter，通過代碼段添加屬性。調度功能開發示例開發步驟調度參數界面配置：跟普通實體視圖配置一樣，需繼承WebViewConfig<T>，調度參數設置中彈出的是表單頁面，所以調用的是ConfigDetailsView視圖，相關字段在ConfigDetailsView設置即可。調度功能開發示例開發步驟調度任務類的開發：命名以Job結尾，繼承JobBase，標記特性[Job(“統計讀者數量”,typeof(ReaderJobParameter))]，實現調度任務執行方法ExecuteJob。調度功能開發示例調度任務類說明[Job("統計讀者數量",typeof(ReaderJobParameter))]所有的調度任務類，都需要標記Job標簽，用于告訴系統當前的類是一個調度任務類，在“調度任務設置”中識別并添加到調度任務中。JobBase所有的調度任務的類，都需要繼承JobBase類，只有繼承了JobBase，才提供相關調度任務的相關標準方法。ExecuteJob繼承了JobBase的類，需要實現ExecuteJob方法，調度器在執行調度任務時，會自動調用調度任務類的ExecuteJob方法，就是說系統在定時執行這個方法。在執行ExecuteJob方法時，會將“調度任務設置”中設置的參數傳給ExecuteJob的param參數。調度功能開發示例調度任務類說明AddLog調度任務在執行過程中，可以將相關的日志信息寫入到數據庫中，同時會在“調度任務設置”功能中看到。需要注意的是，調度任務中執行一次任務，就算寫多個日志信息，都會合并成一個，并不會出現多條記錄。ReaderJobParameter（JobParameter）ReaderJobParameter是自己定義的參數實體，用于提供當前調度任務類可以要接收的自定義業務參數，如果調度任務類不需要設定任何業務參數，則默認為JobParameter即可，即typeof(JobParameter)。調度功能開發示例開發步驟完成后，運行項目，在“調度任務設置”功能中，點擊添加，任務就會添加進來了，就可以進行任務的配置了。04常見異常問題列舉常見異常問題常見異常問題調度平臺執行升級數據庫操作升級表失敗。問題描述：調度平臺相關dll都依賴進來了，也配置了調度的數據庫連接字符串且正確，但是執行升級數據庫操作生成調度平臺表時，生成表失敗。原因：調度平臺如果是使用的sqlserver數據庫，使用平臺的升級數據庫操作可以正常生成調度平臺的表；如果使用的是oracle數據庫，使用平臺的升級數據庫操作無法生成調度平臺的表。解決方案：平臺使用的是oracle的數據庫，則通過腳本生成調度相關表，腳本如下。常見異常問題常見異常問題調度任務需要先禁用再刪除，否則刪除后調度還會在hangfire運行。如果刪除后調度還在運行，可以在調度的控制臺Recurringjobs頁簽進行刪除。常見異常問題常見異常問題部署的調度任務不執行。問題描述：部署后調度任務不執行，對應場景：調度測試環境（windows環境）執行成功，但正式環境（linux+docker）不執行。解決方案：打開調度控制臺檢查linux環境是否時區正確，兩個系統的環境的時區標識是不是樣的。常見異常問題常見異常問題下面第1個圖是windows環境，第2個圖是linux環境。常見異常問題常見異常問題某個調度任務執行失敗。問題描述：其他調度任務都正常，某個調度任務執行不了或者失敗，失敗如下圖。原因：調度服務沒有發布，只發布了Host和BS。解決方案：調度服務、Host和BS同時發布。練習1、工業軟件開發中，開發調度功能，調用任務是以Job結尾，繼承JobBase類及子類嗎?（）2、工業軟件開發中，調度任務需要配置參數是需要繼承JobParameter類嗎?（）3、

工業軟件開發中，調用任務如果定義了參數類并繼承了JobParameter類