diff --git a/entry/build.gradle b/entry/build.gradle index 3881a490cfc985cc4a7ae83389bdeca4cd034653..42100a2c34fe9c7796278621ddc9124afa8ecf25 100644 --- a/entry/build.gradle +++ b/entry/build.gradle @@ -13,4 +13,5 @@ dependencies { testCompile 'junit:junit:4.12' compile project(path: ':timetable') implementation 'com.alibaba:fastjson:1.2.55' + //implementation('com.gitee.chinasoft_ohos:timetable-view:0.0.1-SNAPSHOT') } diff --git a/entry/src/main/java/com/chinasoft/ohos/spinner/MaterialSpinnerBaseAdapter.java b/entry/src/main/java/com/chinasoft/ohos/spinner/MaterialSpinnerBaseAdapter.java index f45c212b035d9bac23455dec770a2c476db07174..e334ceae9828b876a800bc545e16446a0e219d7c 100644 --- a/entry/src/main/java/com/chinasoft/ohos/spinner/MaterialSpinnerBaseAdapter.java +++ b/entry/src/main/java/com/chinasoft/ohos/spinner/MaterialSpinnerBaseAdapter.java @@ -92,7 +92,7 @@ public abstract class MaterialSpinnerBaseAdapter extends RecycleItemProvider /** * getItemText * - * @param position + * @param position 位置信息 * @return ItemText */ public String getItemText(int position) { diff --git a/entry/src/main/java/com/chinasoft/ohos/spinner/Utils.java b/entry/src/main/java/com/chinasoft/ohos/spinner/Utils.java index 080a57d42ac9bb2c80a08b53bb3aaa5068c917a0..491461429a281f2052eeafd845458b04fa8da6b3 100644 --- a/entry/src/main/java/com/chinasoft/ohos/spinner/Utils.java +++ b/entry/src/main/java/com/chinasoft/ohos/spinner/Utils.java @@ -103,9 +103,8 @@ final class Utils { *

Starting in {@link }, the returned drawable will be styled for the * specified Context's theme.

* - * @param drawableId The desired resource identifier, as generated by the aapt tool. - * This integer encodes the package, type, and resource entry. - * The value 0 is an invalid identifier. + * @param drawableId The desired resource identifier + * @param context context * @return Drawable An object that can be used to draw this resource. */ static PixelMapElement getPixelMapElement(Context context, int drawableId) { diff --git a/timetable/src/main/java/com/zhuangfei/timetable/TimetableView.java b/timetable/src/main/java/com/zhuangfei/timetable/TimetableView.java index 62fbe7dfbe8b6677071e77e1ea9eb11f89a4fbb7..e121c97ac23d5515307a65f3aea87772e0b616c8 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/TimetableView.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/TimetableView.java @@ -142,8 +142,8 @@ public class TimetableView extends DirectionalLayout { /** * callback * - * @param onConfigHandleListener - * @return + * @param onConfigHandleListener 监听 + * @return TimetableView */ public TimetableView callback(ISchedule.OnConfigHandleListener onConfigHandleListener) { this.onConfigHandleListener = onConfigHandleListener; @@ -651,6 +651,8 @@ public class TimetableView extends DirectionalLayout { /** * 周次改变时的回调 + * + * @param cur 回调week的index */ private void onBind(int cur) { onWeekChangedListener().onWeekChanged(cur); @@ -881,7 +883,7 @@ public class TimetableView extends DirectionalLayout { /** * 显示旗标布局,立即生效 * - * @return TimetableView + * @return TimetableView 返回布局自身 */ public TimetableView showFlaglayout() { flagLayout().setVisibility(VISIBLE); diff --git a/timetable/src/main/java/com/zhuangfei/timetable/listener/ISchedule.java b/timetable/src/main/java/com/zhuangfei/timetable/listener/ISchedule.java index ccc0787d216c9f962b0aaf816609afed0f59b836..d7acf07864e789d3443b77dc863fc13cd9a0a4f1 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/listener/ISchedule.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/listener/ISchedule.java @@ -59,6 +59,7 @@ public interface ISchedule { * @param itemWidth 课程项宽度,itemWidth:是包含了边距的,设置宽度时所以需要减去边距 * @param itemHeight 课程项高度 * @param marTop 外边距 + * @param marLeft 距离左侧距离 */ void onInit(DirectionalLayout flagLayout, int monthWidth, int itemWidth, int itemHeight, int marTop, int marLeft); @@ -100,7 +101,7 @@ public interface ISchedule { * * @param schedule 该位置对应的课程实体 * @param isThisWeek 该课程是否是本周上 - * @return + * @return 文本 */ String getItemText(Schedule schedule, boolean isThisWeek); @@ -150,8 +151,8 @@ public interface ISchedule { /** * 构建滚动布局时回调 * - * @param scatter - * @return + * @param scatter LayoutScatter + * @return Component */ Component getScrollView(LayoutScatter scatter); } @@ -173,11 +174,11 @@ public interface ISchedule { * 获取View数组 * 被废弃,自v2.0.3起该方法无效 * - * @param scatter 转换器 + * @param scatter 转换器 * @param monthWidth 月份宽度px * @param perWidth 日期每项宽度px * @param height 默认的日期栏高度 - * @return + * @return Component合集 */ Component[] getDateViews(LayoutScatter scatter, float monthWidth, float perWidth, int height); @@ -187,7 +188,10 @@ public interface ISchedule { void onHighLight(); /** - * 更新日期时回调 + * onUpdateDate + * + * @param curWeek 目前周次 + * @param targetWeek 目标周次 */ void onUpdateDate(int curWeek, int targetWeek); } diff --git a/timetable/src/main/java/com/zhuangfei/timetable/listener/OnDateBuildAapter.java b/timetable/src/main/java/com/zhuangfei/timetable/listener/OnDateBuildAapter.java index 792e4eaf3b4600911fa9337fab0c83d78f9ce0ad..6d22ffdddf0bc890a8af0ef0015a75ec33f126dd 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/listener/OnDateBuildAapter.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/listener/OnDateBuildAapter.java @@ -35,9 +35,10 @@ public class OnDateBuildAapter implements ISchedule.OnDateBuildListener { protected DirectionalLayout layout; /** - * @javadoc - * @param background - * @return + * 设置背景色 + * + * @param background 背景色 + * @return OnDateBuildAapter */ public OnDateBuildAapter setBackground(int background) { this.background = background; diff --git a/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleConfig.java b/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleConfig.java index 993f002f9a6ed7a4833b0493845f4b81a80ba18e..4ba242e5510d594f871492f571911fd5ece7ab44 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleConfig.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleConfig.java @@ -112,7 +112,7 @@ public class ScheduleConfig { /** * 获取缓存的属性Map * - * @return + * @return Map */ public Map getConfigMap() { return mConfigMap; diff --git a/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleSupport.java b/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleSupport.java index c2ccede4df6c9d6bce3caa2e410276a2416c533f..31a7bf9cbbaa42ad6b5bb361f56bca1648525488 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleSupport.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/model/ScheduleSupport.java @@ -84,9 +84,9 @@ public class ScheduleSupport { /** * 获取两个日期之间的日期集合 * - * @param start - * @param end - * @return + * @param start 开始日期 + * @param end 结束日期 + * @return list合集 */ private static List getBetweenDates(Date start, Date end) { SimpleDateFormat sdf = new SimpleDateFormat("dd"); @@ -112,7 +112,7 @@ public class ScheduleSupport { * 根据开学时间计算当前周 * * @param startTime 满足"yyyy-MM-dd HH:mm:ss"模式的字符串 - * @return + * @return 时间 */ public static int timeTransfrom(String startTime) { SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); @@ -299,7 +299,8 @@ public class ScheduleSupport { /** * 判断该课是否为本周的 * - * @param cur_week + * @param subject 数据 + * @param cur_week 本周周次 * @return cur_week */ public static boolean isThisWeek(Schedule subject, int cur_week) { @@ -314,8 +315,9 @@ public class ScheduleSupport { /** * 根据当前周过滤课程,获取本周有效的课程(忽略重叠的) * - * @param data - * @param curWeek + * @param data 数据 + * @param curWeek 当前周 + * @param isShowNotCurWeek 是否显示本周 * @return List<> */ public static List fliterSchedule(List data, int curWeek, boolean isShowNotCurWeek) { diff --git a/timetable/src/main/java/com/zhuangfei/timetable/operater/SimpleOperater.java b/timetable/src/main/java/com/zhuangfei/timetable/operater/SimpleOperater.java index eee987108ebb3d3e8554b2de424876370a23bddb..2e5e4fcff28a376bc1ea1e631256d5ec26827875 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/operater/SimpleOperater.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/operater/SimpleOperater.java @@ -146,7 +146,7 @@ public class SimpleOperater extends AbsOperater { /** * 获取旗标布局,需要在showView方法执行后执行 * - * @return + * @return DirectionalLayout */ @Override public DirectionalLayout getFlagLayout() { @@ -181,12 +181,13 @@ public class SimpleOperater extends AbsOperater { } /** - * 构建课程项 + * newItemView * - * @param data 某一天的数据集合 + * @param originData 数据源 + * @param data 某一天的数据集合 * @param subject 当前的课程数据 - * @param pre 上一个课程数据 - * @param i 构建的索引 + * @param pre 上一个课程数据 + * @param i 构建的索引 * @param curWeek 当前周 * @return View */ @@ -583,7 +584,7 @@ public class SimpleOperater extends AbsOperater { /** * getPerWidth * - * @return + * @return 宽度 */ protected float getPerWidth() { float perWidth = 0; @@ -648,6 +649,11 @@ public class SimpleOperater extends AbsOperater { } } + /** + * 日志显示 + * + * @param message 日志信息 + */ private void debug(String message) { HiLog.debug(LOG_LABEL, message); } diff --git a/timetable/src/main/java/com/zhuangfei/timetable/utils/ScreenUtils.java b/timetable/src/main/java/com/zhuangfei/timetable/utils/ScreenUtils.java index c8fee5b72f81297fb5b91049508149e51f55111f..ff21b424f9277eb36ac5a81f14c63fab23f6b0ab 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/utils/ScreenUtils.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/utils/ScreenUtils.java @@ -136,7 +136,7 @@ public class ScreenUtils { /** * rgb颜色 * - * @param + * @param color 色值 * @return RgbColor */ private RgbColor getRgbColor(Color color) { diff --git a/timetable/src/main/java/com/zhuangfei/timetable/view/WeekView.java b/timetable/src/main/java/com/zhuangfei/timetable/view/WeekView.java index d17cadd8b93936da028d3c1de172660d8733a0eb..529a1b0f9f896c183d3f5057447dce65cb6f9351 100644 --- a/timetable/src/main/java/com/zhuangfei/timetable/view/WeekView.java +++ b/timetable/src/main/java/com/zhuangfei/timetable/view/WeekView.java @@ -118,7 +118,7 @@ public class WeekView extends DirectionalLayout implements WeekViewEnable list) { @@ -176,8 +176,8 @@ public class WeekView extends DirectionalLayout implements WeekViewEnable scheduleList) { @@ -191,7 +191,7 @@ public class WeekView extends DirectionalLayout implements WeekViewEnable dataSource() { @@ -225,6 +225,8 @@ public class WeekView extends DirectionalLayout implements WeekViewEnable