首页 文章 精选 留言 我的

精选列表

搜索[文档解析]，共10000篇文章
优秀的个人博客,低调大师

领课教育—在线教育系统（部署文档）

1、项目源码导入 源码地址：https://gitee.com/roncoocom/roncoo-education 觉得我们项目还不错的朋友记得给个Star哦！ 2、项目导入问题解决方法 (1)pom.xml文件报错，如图。 解答：这个是因为jdk和maven导致的，需要把Eclipse改为使用本地JDK(默认为JRE)，maven最低版本要求3.5+ (2)很多get、set方法报错，如图。 解答：由于本项目使用了lombok来优化代码，消除冗长代码，所以如果 Eclipse没配置有lombok这个jar会 报错，需要配置lombok。 在Eclipse根目录加入lombok，eclipse.ini文件加入-javaagent:lombok.jar，重启eclipse即可。 使用IDEA的同学，也可以安装对应的插件 3、数据库脚本导入 获取数据库脚本，请加群！ 群查找请看：https://gitee.com/roncoocom/roncoo-education 4、项目运行 (1)模块介绍： 注册中心（roncoo-education-server-eureka）配置中心（roncoo-education-server-config）课程模块（roncoo-education-course）用户模块（roncoo-education-user）系统模块（roncoo-education-system）后台模块（roncoo-education-boss)定时器（roncoo-education-job)网关工程（roncoo-education-gateway)链路监控（roncoo-education-server-zipkin)应用监控（roncoo-education-server-admin) (2)修改注册中心(application-dev.properties)： info.eureka.host=localhost # 设置不注册自身eureka.client.register-with-eureka=falseeureka.client.fetch-registry=false (3)修改课程、用户、系统、后台模块、应用监控，定时器，网关(bootstrap.properties)： info.eureka.host01=localhostinfo.eureka.host02=localhostspring.profiles.active=dev (4)修改配置中心(application-dev.properties)： spring.data.elasticsearch.cluster-nodes= 节点spring.data.elasticsearch.cluster-name=集群名称spring.redis.host=redis地址spring.redis.port=redis端口spring.redis.password=redis密码 (5)修改配置中心模块工程数据库连接(roncoo-education-course-service-dev.properties)、(roncoo-education-user-service-dev.properties)和(roncoo-education-system-service-dev.properties): spring.datasource.druid.url=本地数据库连接spring.datasource.druid.username=mysql账号spring.datasource.druid.password=mysql密码mysql密码使用durid加密：java -cp druid-1.0.16.jar com.alibaba.druid.filter.config.ConfigTools 你的密码 (6)启动顺序：注册中心 → 配置中心→模块工程 → 定时器 → 网关工程 → 应用监控、链路监控（可以不启动） 注册中心地址：http://localhost:5761管理后台地址：http://localhost:5800网关服务地址：http://localhost:5840 5、运营后台运行 项目名称：roncoo-education-bossapi——主要存放了各个工程的接口config——主要配置网关地址，经过网关请求后台接口views——主要是存放页面修改config里index.js的dev为开发环境网关地址: 本地ip+网关端口修改config里build.js为开发环境网关地址: ip+网关端口 前端运行需要用到node Node版本:9.0.0以上 编译使用：安装依赖：npm install本地开发 启动项目：npm run dev打包正式环境：npm run build访问地址：http://localhost:5800/ 6、前端导入运行 前端源码地址：https://gitee.com/roncoocom/roncoo-education-webapi——主要存放了各个工程的接口config——主要配置网关地址，经过网关请求后台接口pages——主要是存放页面修改config里conf.js的开发环境网关地址: 本地ip+网关端口/#/ 前端运行需要用到Node Node版本: 9.0.0以上 编译使用：npm installnpm run dev前端访问地址：http://127.0.0.1:3000/
2019-03-07
优秀的个人博客,低调大师

PopupWindow 使用详解（一） 中文API 文档 赠送 ListPopupWindow 中文 API

笔者数了数枕巾脱落的头发，发现了 Android 开发常用的类似于弹窗的悬浮窗口 大概是 PopupWindow 和 dialog。之前有还算具体的写过关于 dialog 以及自定义 dialog 甚至是 dialogActivity 的相关笔记，即：Android 系统原生dialog使用 、Android dialog Activity 使用 、android自定义相对复杂dialog 。突然感觉 PopupWindow 这个说简单不简单，说难不难的知识点也应该详细研究一下。下面回归正题，请欣赏笔者的表演： 一、创建 PopupWindow 先说一下 Google 爸爸提供的构造方法 public PopupWindow() public PopupWindow(View contentView) public PopupWindow(int width, int height) public PopupWindow(View contentView, int width, int height) public PopupWindow(View contentView, int width, int height, boolean focusable) public PopupWindow(Context context) public PopupWindow(Context context, AttributeSet attrs) public PopupWindow(Context context, AttributeSet attrs, int defStyleAttr) public PopupWindow(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) 数一数不多不少 9 个构造方法，一个无参的 8 个有参的，参数代表的意思分别为：View contentView 表示该 PopupWindow 内装载的内容，即展示各位用户的内容int width, int height表示该 PopupWindow 对象的长度和宽度，参数可以是 ViewGroup.LayoutParams.WRAP_CONTENT和ViewGroup.LayoutParams.MATCH_PARENT也可以是具体的数值了。但是 这里规定的 是 PopupWindow 内加载到的 view 对象的大小。相当于 PopupWindow 设置的值 为 xml 内最外层布局是等效的。 如果，需要控制加载展示的 view 大小，那么需要将该参数设置ViewGroup.LayoutParams.WRAP_CONTENT 并且 目标样式外再包裹一层布局，类似于： <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent"> <RelativeLayout android:layout_width="200dp" android:layout_height="200dp" android:layout_centerInParent="true"> <ImageView android:id="@+id/iv_home" android:layout_width="wrap_content" android:layout_height="wrap_content" android:contentDescription="@string/app_name" android:src="@mipmap/home" /> </RelativeLayout> </RelativeLayout> boolean focusable PopupWindow 响应内部的点击事件，例如 TextView、Button 等Context context 上下文，不多讲剩下下面的三个构造方法，不常用，但是会自定义 view 的大佬都知道啥意思。 二、常用设置方法 //设置动画特效 即 展示和消失动画 public void setAnimationStyle(int animationStyle) //主要作用是为了设置 PopupWindow 显示的时候是否会与 StatusBar 重叠（如果存在的话也包括 SystemBar ） public void setAttachedInDecor(boolean enabled) //设置 PopupWindow 的背景。该属性不设置的会，会导致 PopupWindow 出现后不会消失，即便是 点击 back 键也不起作用。这应该是 PopupWindow 较为变态的地方。 public void setBackgroundDrawable(Drawable background) //设置 PopupWindow 允许超出窗口 public void setClippingEnabled(boolean enabled) //设置 PopupWindow 内展示的内容 public void setContentView(View contentView) //设置 PopupWindow 的高度，类似于 3D 效果的阴影 public void setElevation(float elevation) //设置 PopupWindow的入场动画 public void setEnterTransition(Transition enterTransition) //有如就得有出 设置出场动画 public void setExitTransition(Transition exitTransition) //设置 popupWindow 是否可以获取焦点 public void setFocusable(boolean focusable) //设置 PopupWindow的高度 public void setHeight(int height) //脸颊事件 Events 都是有大小的当触摸点大于手指头大小时，则为 脸颊事件 ，蛮有意思的 你可以尝试一下。 public void setIgnoreCheekPress() //设置输入法的操作模式 public void setInputMethodMode(int mode) //监听 PopupWindow关闭的事件 public void setOnDismissListener(OnDismissListener onDismissListener) //设置 点击 PopupWindow意外区域，隐藏 popupWindow 然而并没有什么卵用 public void setOutsideTouchable(boolean touchable) // PopupWindow触摸时的监听回调 public void setTouchInterceptor(OnTouchListener l) //设置 PopupWindow是否可触摸 public void setTouchable(boolean touchable) //设置 popwindow 的宽度 public void setWidth(int width) //设置 PopupWindow布局类型 public void setWindowLayoutType(int layoutType) 设置 PopupWindow 显示位置 相对重要 拿出来写 //设置 PopupWindow 在某个控件的下方，某控件的左下角与 PopupWindow 的左上角对齐 public void showAsDropDown(View anchor) //设置 PopupWindow 在某个控件的下方，某控件的左下角与 PopupWindow 的左上角对齐，可以设置偏移量 向左为副 ，向右为正；向上为负，向下为正 public void showAsDropDown(View anchor, int xoff, int yoff) //设置 PopupWindow 在相当于父布局进行摆放，可以设置偏移量。 public void showAtLocation(View parent, int gravity, int x, int y) //隐藏 PopupWindow public void dismiss() 三、常用获取方法 //获取 PopupWindow 动画样式 public int getAnimationStyle() //获取 PopupWindow 背景 public Drawable getBackground() //获取 PopupWindow 设置的 view 返回一个view对象 public View getContentView() //获得 PopupWindow 的悬浮高度 public float getElevation() //获取 PopUpWindow 的入场动画 public float getElevation() //获取 PopupWindow 的出场动画 public Transition getExitTransition() //获取 PopupWindow 的高度 public int getHeight() //获取输入模式 public int getInputMethodMode() //获取 PopupWindow 是否应该与寄生（不太合理但是不知道用啥词）对象重叠 public boolean getOverlapAnchor() //获取 Popwindow 的宽度 public int getWidth() //获取 PopupWindow 的布局类型 public int getWindowLayoutType() //获取可以让 PopupWindow 设置的最大高度 public int getMaxAvailableHeight(View anchor) public int getMaxAvailableHeight(View anchor, int yOffset) //获取可以设置 PopupWindow 的最大高度，可以忽略软键盘。 public int getMaxAvailableHeight( View anchor, int yOffset, boolean ignoreBottomDecorations) 四、常用判断方法 //判断 PopupWindow 是否在超出父布局 public boolean isAboveAnchor() // 判断 PopupWindow 是否在父布局的 装饰上 public boolean isAttachedInDecor() //判读 PopupWindow 是否可以超出窗口 public boolean isClippingEnabled() //判断 PopupWindow 是否可以获取焦点 public boolean isFocusable() //判断 PopupWindow 是否相应自身以外的点击事件 public boolean isOutsideTouchable() //判断 PopupWindow 是否展示 public boolean isShowing() //判断 PopupWindow 是否支持多点触控 public boolean isSplitTouchEnabled() //判断 PopupWindow 是否支持触摸事件 public boolean isTouchable() 五、不常使用 更新位置或更新内容方法 //更新当前 PopupWindow public void update() //更新 Popwindow 到新的形态 参数：长度、宽度 public void update(int width, int height) //更新 Popwindow 到新的位置、新的形态 参数：新位置的坐标，长度、宽度 public void update(int x, int y, int width, int height) //同上 public void update(int x, int y, int width, int height, boolean force) //相对于宿主 更新体型 public void update(View anchor, int width, int height) //相对宿主更新 大小 位置 public void update(View anchor, int xoff, int yoff, int width, int height) 六、部分主要事项 1、 PopupWindow 默认是不允许超出窗口的，具体演示请看下篇笔记； 2、 PopupWindow 的 public void setOutsideTouchable(boolean touchable) 方法默认没有什么卵用 ，是否可以点击 PopupWindow 外部进行隐藏 PopupWindow ，必须设置 public void setBackgroundDrawable(Drawable background) 该方法 3、 getHeight() 和 getWidth() 方法不太好用，一般返回为 0；如果获取 PopupWindow 的长宽建议使用如下方法： devPop.getContentView().measure(0, 0); int hight=devPop.getContentView().getMeasuredHeight(); int width=devPop.getContentView().getMeasuredWidth(); 4、 将 PopupWindow 的四角设置为圆角方法，可以将事先准备的 view 的父布局加一个带有圆角的 shape background， 之后设置 PopupWindow 的 setBackgroundDrawable() 方法 设置为devPop.setBackgroundDrawable(new ColorDrawable(0x00ffffff)); 5、 一定要在显示 PopupWindow 的界面的 OnDestroy（）方法内调用 dismiss（）方法，否则会产生 “意想不到”的惊喜。 @Override protected void onDestroy() { super.onDestroy(); if (popupWindow != null) { popupWindow.dismiss(); } } 6、 笔者遇到的注意事项，感觉目前就这么多了，之后如果遇到还会补充； 七、附赠 ListPopupWindow 相关汉语 API 1、效果展示 或许各位很多人都知道 PopupWindow 但是 少有人知道 ListPopupWindow ，故 展示效果如下，具体应用 请留意之后的 笔记。 2、相关 API 继承结构 （1）、构造方法 public ListPopupWindow( Context context) public ListPopupWindow( Context context, AttributeSet attrs) public ListPopupWindow( Context context, AttributeSet attrs,int defStyleAttr) public ListPopupWindow(Context context, AttributeSet attrs,int defStyleAttr, int defStyleRes) 构造方法就这四种，笔者常用的是第一种。 （2）、设置类方法 //为列表设置 适配器 public void setAdapter( ListAdapter adapter) //设置锚点 view 寄生的view public void setAnchorView(@Nullable View anchor) //为 ListPopupWindow 设置动画样式 public void setAnimationStyle( int animationStyle) //为 ListPopupWindow 设置背景 public void setBackgroundDrawable( Drawable d) //设置 ListPopupWindow 的宽度 单位：像素 public void setContentWidth(int width) //设置下拉列表的对齐方式 public void setDropDownGravity(int gravity) //设置 ListPopupWindow 的高度 单位：像素 public void setHeight(int height) //设置横向偏移量 单位：像素 public void setHorizontalOffset(int offset) //设置 Drawable 为列表的选择器 public void setListSelector(Drawable selector) //将 ListPopupWindow 设置为模态框 public void setModal(boolean modal) //设置 ListPopupWindow 提示位置 public void setPromptView( View prompt) //设置 ListPopupWindow 的选定位置 public void setSelection(int position) //设置 ListPopupWindow 输入区域的输入模式 public void setSoftInputMode(int mode) //设置 ListPopupWindow 的竖直方向偏移量 public void setVerticalOffset(int offset) //设置 ListPopupWindow 的宽度 public void setWidth(int width) //设置 ListPopupWindow 的布局类型 public void setWindowLayoutType(int layoutType) // 可将返回对象 添加到 源视图中，进而实现拖动并打开。 public OnTouchListener createDragToOpenListener(View src) //展示 ListPopupWindow public void show() （3）、监听器 //设置 ListPopupWindow 关闭的 时的监听 public void setOnDismissListener(PopupWindow.OnDismissListener listener) //设置 ListPopupWindow 的 item 单击时的监听回调 public void setOnItemClickListener(AdapterView.OnItemClickListener clickListener) //设置 ListPopupWindow item 被选择 时的监听回调 public void setOnItemSelectedListener(OnItemSelectedListener selectedListener) （4）、获取方法 //获取 ListPopupWindow 的锚点 view public View getAnchorView() //获取 ListPopupWindow 的动画样式 public int getAnimationStyle() //获取 ListPopupWindow 的背景 public Drawable getBackground() //获取 ListPopupWindow 的高度 public int getHeight() //获取 ListPopupWindow 的横向偏移量 public int getHorizontalOffset() //获取 ListPopupWindow 的 列表 public ListView getListView() //获取可选的 ListPopupWindow 的位置 public int getPromptPosition() //获取 ListPopupWindow 内被选中的 item public Object getSelectedItem() //获取被选中的 item 的 id public long getSelectedItemId() //获取被选中的 item 的位置 public int getSelectedItemPosition() //获取被选中的 view public View getSelectedView() //获取 垂直方向的偏移量 单位：像素 public int getVerticalOffset() //获取 ListPopupWindow 的宽度 public int getWidth() （5）、判断方法 //判断是否为 模态框样式 public boolean isModal() //判断是否为显示状态 public boolean isShowing() //过了关键按键 点击事件 public boolean onKeyDown(int keyCode, KeyEvent event) //过滤关键按键 点击抬起事件 public boolean onKeyUp(int keyCode, KeyEvent event) //判断 是否 在指定 item 下执行点击事件 public boolean performItemClick(int position) （6）、其他的重要方法 //执行相关 对 ui 线程的操作 public void postShow() //删除 当前列表的所有选择 public void clearListSelection() //关闭 ListPopupWindow public void dismiss() 3、关于 ListPopupWindow 的其它 杂谈 当发现这个 ListPopupWindow 算是控件的工具值，笔者舍去很多地方的 ListView 和部分AutoCompleteTextView 和 Spinner 控件使用，因为 ListPopupWindow 搭配 TextView 或者搭配 EditText 极其好用。 今天学习就到这里，笔者希望可以帮助各位在伙伴，欢迎大佬指点、批评还有建议；之后的几篇笔者尽快写出来，只是一些 关于 ListPopupWindow 和 PopupWindow 的具体用法，相关源码会上传 github ；不介意各位读者，帮忙点个心或者是加个关注哈 (︶.̮︶) ！
2018-10-22
优秀的个人博客,低调大师

Android 3.0 r1 API中文文档(107) —— AsyncPlayer

正文 一、结构 public classAsyncPlayer extendsObject java.lang.Object android.media.AsyncPlayer 二、概述 播放一个连续 ( 多个 ) 的音频 URLs ，但那些任务较重的工作在另外的线程中完成，所以任何预处理或加载的延迟都不阻碍线程调用。 三、构造函数 publicAsyncPlayer(String tag) 构造一个AsyncPlayer对象。 参数 tag用于调试的字符串 四、公共方法 public voidplay(Context context, Uri uri, boolean looping, int stream) 开始播放声音。可在某个点上开始播放。这里不保证可能有延迟。在另一个音频文件播放时调用这个方法将导致当前音频停止播放并开始播放新的音频。 参数 context 应用程序上下文 uri 播放的URI (参见setDataSource(Context, Uri)) looping是否无限循环播放声音。(参见setLooping(boolean)) stream音频流(AudioStream)类型(参见setAudioStreamType(int))（译者注：例如AudioManager.STREAM_MUSIC） public voidstop() 停止之前播放的声音。不能在某点上暂停然后接着播放。多次调用没有不良影响。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582378，如需转载请自行联系原作者
2017-11-21
优秀的个人博客,低调大师

Android 3.0 r1 API中文文档(113) ——SlidingDrawer

正文 一、结构 public classSlidingDrawer extendsViewGroup java.lang.Object android.view.View android.view.ViewGroup android.widget.SlidingDrawer 二、概述 SlidingDrawer （滑动式抽屉）隐藏屏外的内容，并允许用户拖拽一个 handle 以显示隐藏的内容。 SlidingDrawer 可以在垂直或者水平使用。它由两个子视图组成：一个是用户拖拽的 handle （柄），另一个是随着拖动变化的 content （内容）。 SlidingDrawer 应当作为内部布局的覆盖来使用，也就是说 SlidingDrawer 内部应该使用 FrameLayout 或 RelativeLayout 布局。 SlidingDrawer 的大小决定了其内容显示时所占空间的大小，所以它的尺寸一般定义为 match_parent 。在 XML 布局中 SlidingDrawer 必须指定 handle 和 content 的 id ： 三、内部类 interface SlidingDrawer.OnDrawerCloseListener 当drawer（抽屉）关闭时调用 interface SlidingDrawer.OnDrawerOpenListener 当drawer（抽屉）打开时调用 interface SlidingDrawer.OnDrawerScrollListener 当drawer（抽屉）滑动（滚动）时调用 四、XML属性 属性名称 描述 android:allowSingleTap 指示是否可通过单击handle打开或关闭（如果是false，刚用户必须通过拖动，滑动或者使用轨迹球，来打开/关闭抽屉。）默认的是true。 android:animateOnClick 指示当用户点击handle的时候，抽屉是否以动画的形式打开或关闭。默认的是true。 android:bottomOffset Handle距离SlidingDrawer底部的额外距离 android:content 标识SlidingDrawer的内容 android:handle 标识SlidingDrawer的handle（译者注：如按钮） android:orientation SlidingDrawer的方向。必须是下面的一个值： 常量 值 描述 horizontal 0 水平方向对齐 vertical 1 竖直方向对齐 android:topOffset Handle距离SlidingDrawer顶部的额外距离 五、常量 public static final intORIENTATION_HORIZONTAL （译者注：水平方向对齐） 常量值：0 (0x00000000) public static final intORIENTATION_VERTICAL （译者注：垂直方向对齐） 常量值：1 (0x00000001) 六、构造函数 publicSlidingDrawer(Context context, AttributeSet attrs) 用xml中设置的属性来创建一个新的SlidingDrawe 参数 context上下文 attrs XML中定义的属性 public SlidingDrawer (Context context, AttributeSet attrs, int defStyle) 用xml中设置的属性来创建一个新的SlidingDrawe 参数 context上下文 attrs XML中定义的属性 defStyle要应用到这个组件上的样式 七、公共方法 public voidanimateClose() 动画效果关闭抽屉。 参见 close() open() animateOpen() animateToggle() toggle() public voidanimateOpen() 动画效果打开抽屉。 参见 close() open() animateOpen() animateToggle() toggle() public voidanimateToggle() 在打开和关闭抽屉之间动画切换 参见 close() open() animateOpen() animateToggle() toggle() public voidclose() 立即关闭抽屉 参见 open() toggle() animateClose() public ViewgetContent() 返回抽屉的内容(content) 返回值 返回在抽屉内容的视图，它在XML中是用“content”id标识的 public ViewgetHandle() 返回抽屉的handle 返回值 返回在抽屉handle的视图，它在XML中是用“handle”id标识的 public booleanisMoving() 抽屉是否在滚动或滑动。 返回值 如果在滚动或滑动，返回true，否则返回false public booleanisOpened() 当前抽屉是否被完全打开 返回值 如果是打开的，返回true，否则返回false。 public voidlock() 锁定SlidingDrawer，忽略触摸事件 参见 unlock() public booleanonInterceptTouchEvent(MotionEvent event) 实现这个方法可以拦截所有的触屏事件，它在事件被传到子类之前拦截，并获得当前手势的所有权。 使用这个方法时要注意，因为它与View.onTouchEvent(MotionEvent)有一个相当复杂的交互，使用它需要用正确的方法来实现。事件会按照下列顺序接受： 1.down事件会被首先传到本方法中。 2.这个down事件会被当前viewgroup的onTouchEvent()方法或者其各个子视图处理，也就是说你应该实现onTouchEvent()方法并返回true，你会继续看到剩下事件的传递（而不是找一个parent view处理它）。同样的，从onTouchEvent()中返回true，你不会在onInterceptTouchEvent()中接受到任何接下来的事件，并且所有的事件都会被onTouchEvent()处理。 3.如果当前方法返回false，所有接下来的事件（截止到最后包含注册的事件）首先都会被继续传到这里，然后一起传递给目标的onTouchEvent()方法。截至及包括最后注册。 4.如果在这里返回true，将不会收到以下任何事件：目标view将收到同样的事件但是是伴随ACTION_CANCEL事件，并且所有的更进一步的事件将会传递到你自己的onTouchEvent()方法中而不会再在这里出现。 （译者著：这里实在是太麻烦了，很不好懂，我自己看着都头晕，在网上找到一篇很不错的总结，才知道是怎么回事，这里总结一下，记住这个原则你就会很清楚了： 1、onInterceptTouchEvent()是用于处理事件（类似于预处理，当然也可以不处理）并改变事件的传递方向，也就是决定是否允许Touch事件继续向下（子控件）传递，一但返回True（代表事件在当前的viewGroup中会被处理），则向下传递之路被截断（所有子控件将没有机会参与Touch事件），同时把事件传递给当前的控件的onTouchEvent()处理；如果返回false，则把事件交给子控件的onInterceptTouchEvent()处理 2、onTouchEvent()用于处理事件，返回值决定当前控件是否消费（consume）了这个事件，也就是说在当前控件在处理完Touch事件后，是否还允许Touch事件继续向上（父控件）传递，一但返回True，则父控件不用操心自己来处理Touch事件。 相关文章这里1、这里2） 参数 event分层次的动作事件 返回值 如果将运动事件从子视图中截获并且通过onTouchEvent()发送到当前ViewGroup，返回true。当前目标将会收到ACTION_CANCEL事件，并且不再会有其他消息传递到此。 public booleanonTouchEvent(MotionEvent event) 实现触摸屏幕事件的方法 参数 event当前事件 返回值 如果事件被处理就返回true，否则返回false public voidopen() 立即打开抽屉 参见 toggle() close() animateOpen() public voidsetOnDrawerCloseListener(SlidingDrawer.OnDrawerCloseListener onDrawerCloseListener) 给抽屉的关闭事件绑定监听器 参数 onDrawerCloseListener抽屉关闭时的监听器 public voidsetOnDrawerOpenListener(SlidingDrawer.OnDrawerOpenListener onDrawerOpenListener) 给抽屉的打开事件绑定监听器 参数 onDrawerOpenListener抽屉打开时的鉴别器 public voidsetOnDrawerScrollListener(SlidingDrawer.OnDrawerScrollListener onDrawerScrollListener) 给抽屉的滚动(收缩)事件绑定监听器，轻滑(fling)也被当作一个滚动(收缩)事件，同时它可以触发抽屉关闭或者打开事件。 参数 onDrawerScrollListener当滚动(收缩)开始或者停止时通知的监听器 public voidtoggle() 在抽屉打开或关闭状态之间切换。事件会立即产生。 参见 close() open() animateOpen() animateToggle() toggle() public voidunlock() 解锁SlidingDrawer使触摸事件能被处理 参见 lock() 八、补充 文章精选 Android高手进阶教程(二)之----Android Launcher抽屉类SlidingDrawer的使用 SlidingDrawer抽屉类{Android学习指南} MotionEvent事件在onInterceptTouchEvent()、onTouchEvent()中的传递顺序 http://hi.baidu.com/j_fo/blog/item/7321c91324203437dc54017d.html http://www.cnblogs.com/rocky_yi/archive/2011/01/21/1941522.html# 示例代码 < SlidingDrawer android:id ="@+id/drawer" android:layout_width ="match_parent" android:layout_height ="match_parent" android:handle ="@+id/handle" android:content ="@+id/content" > < ImageView android:id ="@id/handle" android:layout_width ="88dip" android:layout_height ="44dip" /> < GridView android:id ="@id/content" android:layout_width ="match_parent" android:layout_height ="match_parent" /> </ SlidingDrawer > SlidingDrawer.OnDrawerCloseListener 译者署名：xiaoQLu 译者链接：http://www.cnblogs.com/xiaoQLu 版本：Android 3.0 r1 结构 继承关系 public static interfaceSlidingDrawer.OnDrawerCloseListener android.widget.SlidingDrawer.OnDrawerCloseListener 类概述 当抽屉被关闭时调用的回调。 公共方法 public abstract voidonDrawerClosed() 当抽屉被完全关闭时调用 补充 文章精选 Android控件之SlidingDrawer（滑动式抽屉）详解与实例 SlidingDrawer.OnDrawerOpenListener 译者署名：xiaoQLu 译者链接：http://www.cnblogs.com/xiaoQLu 版本：Android 3.0 r1 结构 继承关系 public static interfaceSlidingDrawer.OnDrawerOpenListener android.widget.SlidingDrawer.OnDrawerOpenListener 类概述 当抽屉被打开时调用 公共方法 public abstract voidonDrawerOpened() 当抽屉被完全打开时调用 SlidingDrawer.OnDrawerScrollListener 译者署名：xiaoQLu 译者链接：http://www.cnblogs.com/xiaoQLu 版本：Android 3.0 r1 结构 继承关系 public static interfaceSlidingDrawer.OnDrawerScrollListener android.widget.SlidingDrawer.OnDrawerScrollListener 类概述 当抽屉被滚动时调用 公共方法 public abstract voidonScrollEnded() 当用户停止拖曳/滑动抽屉的handle时调用 public abstract voidonScrollStarted() 当用户开始拖曳/滑动抽屉的handle时调用 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582369，如需转载请自行联系原作者
2017-11-15
优秀的个人博客,低调大师

Android 3.0 r1 API中文文档(106) —— SimpleCursorAdapter

正文 一、结构 public classSimpleCusrorAdapter extendsResourceCusorAdpater java.lang.Object android.widget.BaseAdapter android.widget.CursorAdapter android.widget.ResourceCusorAdapter android.widget.SimpleCusorAdapter 二、概述 这是一个用起来很方便的适配器类，它主要将Cursor与TexiView或ImageView进行映射。比如，你想设定要展示三列，那么当做好绑定之后，视图就会展示你设定好的那些列；当然了，视图的外观是定义在XML文件里面的，你只需用这个类与视图做好绑定就可以了。与视图绑定有两个阶段。第一阶段：如果SimpleCursorAdapter.ViewBinder可用，将会调用setViewValue(android.view.View, android.database.Cursor, int)方法。该方法返回true就说明绑定成功，否则返回false，这就到了第二阶段，SimpleCursorAdapter内部开始自行绑定，过程是这样的，若绑定到TextView上，调用setViewText();若绑定到ImageView上，调用setViewImage();如果视图不是TextView或ImageView则抛出IllegalStateException异常。当使用带有过滤器的适配器时，例如，在APIDemo中有个AutoCompleteTextView的例子，我们能使用SimpleCursorAdapter.CursorToStringConverter和接口FilterQueryProvider来控制过滤过程。更多信息请参考convertToString(android.database.Cursor)和runQueryOnBackgroundThread(CharSequence)。 三、内部类 public interfaceSimpleCusorAdapter.ViewBinder 这个内部接口可以在外部通过SimpleCursorAdapter.ViewBinder的方式进行Cursor与View的绑定。 public interfaceSimpleCusorAdapter.CursorToStringConverter 这个内部接口可以在外部通过 SimpleCursorAdapter.CursorToStringConverter 的方式 定义怎样将 Cursor 转换成字符串。 四、构造函数 publicSimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to) 构造函数启动自动重新查询(auto-requery)。 这个构造器已被标记为弃用(@Deprecated)。 该方法不推荐使用，Cursor查询操作是执行在应用程序的UI线程当中，那么会导致无响应的情况。另一种方式是使用LoaderManager和CursorLoader来进行。 （译者注：3.0已不推荐使用该构造方法） 参数 context应用程序上下文，具体来说就是ListView所在的上下文当中。 layout布局文件的资源定位标识符，也就是说标识了ListView中的item。那么这个布局文件至少包含了参数“to”中的传进来值。 c 数据库游标，如果游标不可用则为null。 from列名字列表，表示着你要绑定到UI上的列。如果游标不可用则为null。 to展示参数“from”中的列，也就是说ListView中的视图显示的是参数“from”的列值，这些视图应该都是TextView。如果游标不可用则为null。 publicSimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[]to,int flags) 该适配器类标准的构造函数。（译者注：3.0新添的构造方法） 参数 context应用程序上下文，具体来说就是ListView所在的上下文当中。 layout布局文件的资源定位标识符，也就是说标识了ListView中的item。那么这个布局文件至少包含了参数“to”中的传进来值。 c数据库游标，如果游标不可用则为null。 from列名字列表，表示着你要绑定到UI上的列。如果游标不可用则为null。 to展示参数“from”中的列，也就是说ListView中的视图显示的是参数“from”的列值，这些视图应该都是TextView。如果游标不可用则为null。 flags 这个标志用来决定该适配器的行为。 ( 译者注： Android3.0 推荐我们传递 CursorAdapter.FLAG_REGISTER_CONTENT_OBSERVER 。设置标志用来添加一个监听器，监听着参数 cursor 的数据是否有更变。 ) 四、公共方法 public voidbindView(View view, Context context, Cursor cursor) 绑定所有构造函数中的参数from（字段名）一一绑定到参数to（视图资源ID）。与视图绑定有两个阶段。第一阶段：如果SimpleCursorAdapter.ViewBinder可用，将会调用setViewValue(android.view.View, android.database.Cursor, int)方法。该方法返回true就说明绑定成功，否则返回false，这就到了第二阶段，SimpleCursorAdapter内部开始自行绑定，过程是这样的，若绑定到TextView上，调用setViewText();若绑定到ImageView上，调用setViewImage();如果视图不是TextView或ImageView则抛出IllegalStateException异常。 参数 view已存在的视图(View)对象,也就是早先new出来的。 context应用程序上下文。 cursor 数据库游标。该游标已经移动到指定位置上。 异常 IllegalStateException如果绑定的视图中不是TextView或是ImageView则会抛出这个异常。 参见 bindView(android.view.View, android.content.Context, android.database.Cursor) getViewBinder() setViewBinder(android.widget.SimpleCursorAdapter.ViewBinder) setViewImage(ImageView, String) setViewText(TextView, String) public voidchangeCursorAndColumns(Cursor c, String[] from, int[] to) 同时更改Cursor与View的映射关系。 参数 c数据库游标，如果游标不可用则为null。 from列名字列表，表示着你要绑定到UI上的列。如果游标不可用则为null。 to展示参数“from”中的列，也就是说ListView中的视图显示的是参数“from”的列值，这些视图应该都是TextView。如果游标不可用则为null。 public CharSequenceconvertToString(Cursor cursor) 通过CursorToStringConverter接口实现并返回一个CharSequence类型的值，以表示指定的Cursor。如果没有设置CursorToStringConverter，那么就会用另外的方式进行转换。如果列数为-1，或者cursor为null返回空串，否则返回cursor.toString()。 参数 cursor 转换为CharSequence的数据库游标。 返回值 返回一个不为null的CharSequence类型来表示参数cursor。 public SimpleCursorAdapter.CursorToStringConvertergetCursorToStringConverter() 返回自定义的SimpleCursorAdapter.CursorToStringConverter的实现。 返回值 如果没有设置SimpleCursorAdapter.CursorToStringConverter，则为null。 参考 setCursorToStringConverter(android.widget.SimpleCursorAdapter.CursorToStringConverter) getStringConversionColumn() setStringConversionColumn(int) convertToString(android.database.Cursor) public intgetStringConversionColumn() 返回转换成String类型的列位置。 返回值 返回列位置，如果没有则返回-1。 参考 convertToString(android.database.Cursor) setStringConversionColumn(int) setCursorToStringConverter(android.widget.SimpleCursorAdapter.CursorToStringConverter) getCursorToStringConverter() public SimpleCursorAdapter.ViewBindergetViewBinder() 返回SimpleCursorAdapter.ViewBinder引用，这个ViewBinder用来将数据绑定到视图上的。 返回值 如果ViewBinder不存在，则返回null。 参考 bindView(android.view.View, android.content.Context, android.database.Cursor) setViewBinder(android.widget.SimpleCursorAdapter.ViewBinder) public voidsetCursorToStringConverter(SimpleCursorAdapter.CursorToStringConverter cursorToStringConverter) 设置String转换器。 参数 cursorToStringConverterString转换器,设置为null就意味着移除。 参考 setCursorToStringConverter(android.widget.SimpleCursorAdapter.CursorToStringConverter) getStringConversionColumn() setStringConversionColumn(int) convertToString(android.database.Cursor) public voidsetStringConversionColumn(int stringConversionColumn) 设置Cursor中的列要转换成String类型的位置。不过仅当未设置CursorToStringConverter时，这个列才会进行默认转换。 参数 stringConversionColumn列位置，如果参数为-1，则使用默认转换机制。 参考 convertToString(android.database.Cursor) getStringConversionColumn() setCursorToStringConverter(android.widget.SimpleCursorAdapter.CursorToStringConverter) getCursorToStringConverter() public voidsetViewBinder(SimpleCursorAdapter.ViewBinder viewBinder) 设置视图绑定器。 参数 viewBinder视图绑定器，可用为null删除现有的绑定器。 参考 bindView(android.view.View, android.content.Context, android.database.Cursor) getViewBinder() public voidsetViewImage(ImageView v, String value) 仅当ViewBinder不存在或是当ViewBinder不为ImageView绑定时（也就是setViewValue()返回false），则这个方法会被bindView()调用，以便为ImageView设置图片。默认情况下，参数value作为图片资源ID来看待，否则，会视为图片的Uri。另外还可以通过过滤器来获得更灵活的设置。 参数 v图片控件引用 value图片资源ID，是从Cursor获取到的。 public voidsetViewText(TextView v, String text) 仅当ViewBinder不存在或是当ViewBinder不为TextView绑定时（也就是setViewValue()返回false），则这个方法会被bindView()调用，以便为TextView设置文本。可用重写适配器从数据库中检索过滤字符串。 参数 v文本控件引用 value为文本控件设置的文本信息（译者注：是从Cursor获取到的）。 public CursorswapCursor(Cursor c) 交换两个Cursor的列以及它们的数据，并最终返回的还是旧的Cursor。不同于changeCursor(Cursor)的是，旧的Cursor非但不会关闭，而且还会返回出去。（译者注： 3.0新添的方法） 参数 c新的Cursor对象。 返回值 返回旧的 Cursor 引用，如果参数 cursor 不可用，则返回 null 。如果参数 cursor 与原来的 Cursor 引用相同，那么也返回 null 。 五、补充 文章精选 ArrayAdapter和SimpleCursorAdapter例子 Android API : SimpleCursorAdapter() 示例代码 Demo_SimpleCursorAdapter（深夜未眠）.rar SimpleCursorAdapter.CursorToStringConverter 译者署名：深夜未眠 译者链接：http://chris1012f.javaeye.com/ 版本：Android 3.0 r1 正文 一、结构 public static interfaceSimpleCusrorAdapter.CursorToStringConverter java.lang.Object android.widget.SimpleCursorAdapter.CursorToStringConverter 二、概述 这个内部接口可以在外部通过SimpleCursorAdapter.CursorToStringConverter的方式定义怎样将Cursor转换成字符串。 参见 convertToString(android.database.Cursor) 三、公共方法 public abstract CharSequenceconvertToString(Cursor cursor) 返回CharSequence类型的值，用来表示参数cursor。 参数 cusor需要转换成CharSequence类型的数据库游标。 返回值 返回代表参数cursor的非空字符串。 SimpleCursorAdapter.ViewBinder 译者署名：深夜未眠 译者链接：http://chris1012f.javaeye.com/ 版本：Android 3.0 r1 正文 一、结构 public static interfaceSimpleCusrorAdapter.ViewBinder java.lang.Object android.widget.SimpleCursorAdapter.ViewBinder 二、概述 这个内部接口可以在外部通过SimpleCursorAdapter.ViewBinder的方式进行Cursor与View的绑定。Android推荐我们采用这种方式进行绑定操作，而不是沿用SimpleCursorAdapter内部的方式。 参见 bindView(android.view.View, android.content.Context, android.database.Cursor) setViewImage(ImageView, String) setViewText(TextView, String) 三、公共方法 public abstract booleansetViewValue(View view, Cursor cursor, int columnIndex) 将指定的列数据绑定到指定的视图上。当ViewBinder处理时，这个方法必须返回true。如果这个方法返回false，SimpleCursorAdapter将用自己的方式进行绑定操作。 参数 view被绑定的视图。 cursor数据库游标，绑定数据从它这里获取 columnIndex列位置，能够在数据库游标中寻找到。 返回值 返回true意味着数据与视图已经绑定上，否则为未绑定上。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582379，如需转载请自行联系原作者
2017-11-14
优秀的个人博客,低调大师

Android 3.0 r1 API中文文档(108) —— ExpandableListAdapter

正文 一、结构 public interfaceExpandableListAdapter android.widget.ExpandableListAdapter 间接子类 BaseExpandableListAdapter,CursorTreeAdapter,ResourceCursorTreeAdapter, SimpleCursorTreeAdapter, SimpleExpandableListAdapter 二、概述 这个适配器在 ExpandableListView 和底层数据之间起到了一个衔接的作用。该接口的实现类提供了访问子元素（以组的形式将它们分类）的数据；同样，也提供了为子元素和组创建相应的视图。 三、公共方法 public abstract booleanareAllItemsEnabled() ExpandableListAdapter里面的所有条目都可用吗？如果是yes，就意味着所有条目可以选择和点击了。 返回值 返回True表示所有条目均可用。 参见 areAllItemsEnabled() public abstract CursorgetChild(int groupPosition, int childPosition) 获取指定组中的指定子元素数据。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（相对于其它子元素） 返回值 返回指定子元素数据。 public abstract longgetChildId(int groupPosition, int childPosition) 获取指定组中的指定子元素ID，这个ID在组里一定是唯一的。联合ID（参见getCombinedChildId(long, long)）在所有条目（所有组和所有元素）中也是唯一的。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（相对于其它子元素） 返回值 子元素关联ID。 public abstract ViewgetChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent) 获取一个视图对象，显示指定组中的指定子元素数据。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（决定返回哪个视图） isLastChild子元素是否处于组中的最后一个 convertView重用已有的视图(View)对象。注意：在使用前你应该检查一下这个视图对象是否非空并且这个对象的类型是否合适。由此引伸出，如果该对象不能被转换并显示正确的数据，这个方法就会调用getChildView(int, int, boolean, View, ViewGroup)来创建一个视图(View)对象。 parent 返回的视图(View)对象始终依附于的视图组。 返回值 指定位置上的子元素返回的视图对象 public abstract intgetChildrenCount(int groupPosition) 获取指定组中的子元素个数 参数 groupPosition组位置（决定返回哪个组的子元素个数） 返回值 指定组的子元素个数 public abstract longgetCombinedChildId(long groupId, long childId) 从列表所有项(组或子项)中获得一个唯一的子ID号。可折叠列表要求每个元素(组或子项)在所有的子元素和组中有一个唯一的ID。本方法负责根据所给的子ID号和组ID号返回唯一的ID。此外，若hasStableIds()是true，那么必须要返回稳定的ID。 参数 groupId包含该子元素的组ID childId子元素的ID 返回值 列表所有项(组或子项)中唯一的(和可能稳定)的子元素ID号。（译者注：ID理论上是稳定的，不会发生冲突的情况。也就是说，这个列表会有组、子元素，它们的ID都是唯一的。） public abstract CursorgetGroup(int groupPosition) 获取指定组中的数据 参数 groupPosition组位置 返回值 返回组中的数据，也就是该组中的子元素数据。 public abstract intgetGroupCount() 获取组的个数 返回值 组的个数 public abstract longgetGroupId(int groupPosition) 获取指定组的ID，这个组ID必须是唯一的。联合ID(参见getCombinedGroupId(long))在所有条目(所有组和所有元素)中也是唯一的。 参数 groupPosition组位置 返回值 返回组相关ID public abstract ViewgetGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent) 获取显示指定组的视图对象。这个方法仅返回关于组的视图对象，要想获取子元素的视图对象，就需要调用getChildView(int, int, boolean, View, ViewGroup)。 参数 groupPosition组位置（决定返回哪个视图） isExpanded 该组是展开状态还是伸缩状态 convertView重用已有的视图对象。注意：在使用前你应该检查一下这个视图对象是否非空并且这个对象的类型是否合适。由此引伸出，如果该对象不能被转换并显示正确的数据，这个方法就会调用getGroupView(int, boolean, View, ViewGroup)来创建一个视图(View)对象。 parent返回的视图对象始终依附于的视图组。 返回值 返回指定组的视图对象 public abstract booleanhasStableIds() 组和子元素是否持有稳定的ID,也就是底层数据的改变不会影响到它们。 返回值 返回一个Boolean类型的值，如果为TRUE，意味着相同的ID永远引用相同的对象。 public abstract booleanisChildSelectable(int groupPosition, int childPosition) 是否选中指定位置上的子元素。 参数 groupPosition组位置（该组内部含有这个子元素） childPosition子元素位置 返回值 是否选中子元素 public abstract booleanisEmpty() 返回值 如果当前适配器不包含任何数据则返回True。经常用来决定一个空视图是否应该被显示。一个典型的实现将返回表达式getCount() == 0的结果，但是由于getCount()包含了头部和尾部，适配器可能需要不同的行为。 参见 isEmpty() public abstract voidonGroupCollapsed(int groupPosition) 当组收缩状态的时候此方法被调用。 参数 groupPosition收缩状态的组索引 public abstract voidonGroupExpanded(int groupPosition) 当组展开状态的时候此方法被调用。 参数 groupPosition展开状态的组位置 public abstract voidregisterDataSetObserver(DataSetObserver observer) 注册一个观察者(observer)，当此适配器数据修改时即调用此观察者。 参数 observer当数据修改时通知调用的对象。 public abstract voidunregisterDataSetObserver(DataSetObserver observer) 取消先前通过registerDataSetObserver(DataSetObserver)方式注册进该适配器中的观察者对象。 参数 observer 取消这个观察者的注册 四、补充 文章精选 android可展开（收缩）的列表ListView(ExpandableListView) android CursorAdapter的监听事件 ExpandableListView.OnChildClickListener 译者署名：情敌贝多芬 译者链接：http://liubey.javaeye.com/ 版本：Android 3.0 r1 结构 继承关系 public static interfaceExpandableListView.OnChildClickListener java.lang.Object android.widget.ExpandableListView.OnChildClickListener 子类及间接子类 间接子类 ExpandableListActivity 类概述 这是一个定义了当可折叠列表(expandable list)里的子元素(child)发生点击事件时调用的回调方法的接口。 公共方法 public abstract booleanonChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, long id) 用当可折叠列表里的子元素(child)被点击的时候被调用的回调方法。 参数 parent 发生点击动作的ExpandableListView v 在expandable list/ListView中被点击的视图(View) groupPosition 包含被点击子元素的组(group)在ExpandableListView中的位置(索引) childPosition被点击子元素(child)在组(group)中的位置 id 被点击子元素(child)的行ID(索引) 返回值 当点击事件被处理时返回 true ExpandableListView.OnGroupClickListener 译者署名：情敌贝多芬 译者链接：http://liubey.javaeye.com/ 版本：Android 3.0 r1 结构 继承关系 public static interfaceExpandableListView.OnGroupClickListener java.lang.Object android.widget.ExpandableListView.OnGroupClickListener 类概述 这是一个定义了当可折叠列表(expandable list)里的组(group)发生点击事件时调用的回调方法的接口。 公共方法 public abstract booleanonGroupClick(ExpandableListView parent, View v, int groupPosition, long id) 用当可折叠列表里的组(group)被点击的时候被调用的回调方法。 参数 parent发生点击事件的ExpandableListConnector v 在expandable list/ListView中被点击的视图(View) groupPosition被点击的组(group)在ExpandableListConnector中的位置(索引) id 被点击的组(group)的行ID(索引) 返回值 当点击事件被处理的时候返回true ExpandableListView.OnGroupCollapseListener 译者署名：深夜未眠 译者链接：http://chris1012f.javaeye.com/ 版本：Android 3.0 r1 结构 继承关系 public interfaceExpandableListView.OnGroupCollapseListener java.lang.Object android.widget.ExpandableListView.OnGroupCollapseListener 子类及间接子类 间接子类 ExpandableListActivity 类概述 当收缩某个组时，就会发出通知。 公共方法 public abstract void onGroupCollapse (int groupPosition) 每当收缩当前可伸缩列表中的某个组时，就调用该方法。 参数 groupPosition组位置，也就是收缩的那个组的位置。 ExpandableListView.OnGroupExpandListener 译者署名：深夜未眠 译者链接：http://chris1012f.javaeye.com/ 版本：Android 3.0 r1 结构 继承关系 public interfaceExpandableListView.OnGroupExpandListener java.lang.Object android.widget.ExpandableListView.OnGroupExpandListener 子类及间接子类 间接子类 ExpandableListActivity 类概述 当展开某个组时，就会发出通知。 公共方法 public abstract void onGroupExpand (int groupPosition) 每当展开当前可伸缩列表中的某个组时，就调用该方法。 参数 groupPosition 组位置，也就是展开的那个组的位置。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582376，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

android 官方文档中的一些错误收集

1,Intents and Intent Filters 中<data> 的 说明 原文: For example, in the following URI, content://com.example.project:200/folder/subfolder/etc the scheme is "content", the host is "com.example.project", the port is "200", and the path is "folder/subfolder/etc". The host and port together constitute the URIauthority; if a host is not specified, the port is ignored. 这里的错误的地方在于path=”folder/subfolder/etc” 而实际上path=”/folder/subfolder/etc” 在首位应该还有一个分隔符,少了这个分隔符,将无法匹配<data> 由android 2.2 测试实际方法得出: ps:有同样的错误的文章 Content Providers 中 Content URI Summary C 项的解释 本文转自 liam2199 博客，原文链接：http://blog.51cto.com/youxilua/773123如需转载请自行联系原作者
2017-11-08
优秀的个人博客,低调大师

Android 3.0 r1 API中文文档(105) —— ViewParent

正文 一、结构 public interfaceViewParent android.view.ViewParent 间接子类 AbsListView, AbsSpinner, AbsoluteLayout, AdapterView<T extends Adapter>, AppWidgetHostView, DatePicker, DialerFilter, ExpandableListView, FrameLayout, Gallery, GestureOverlayView, GridView, HorizontalScrollView, ImageSwitcher, LinearLayout, ListView, MediaController, RadioGroup, RelativeLayout, ScrollView, SlidingDrawer, Spinner, TabHost, TabWidget, TableLayout, TableRow, TextSwitcher, TimePicker, TwoLineListItem, ViewAnimator, ViewFlipper, ViewGroup, ViewSwitcher, WebView, ZoomControls 二、类概述 定义了一些作为View父类，它所具有的功能（译者注：也可以理解为方法）。当一个View与父类交互时，就可以用到这些API了。（译者注：Android中子控件维系一个ViewParent对象，该对象象征着整个控件树的管理者，子控件产生影响整个控件树的事件时，会通知到ViewParent，ViewParent会将其转换成一个自顶向下的事件，分发下去。参照这里） 三、公共方法 public abstract voidbringChildToFront(View child) 把该视图置于其他所有子视图之上。（译者注：如在FrameLayout中切换被叠放的视图） 参数 child 需要改变顺序的子视图 public abstract voidchildDrawableStateChanged(View child) 当子视图的drawable状态发生变化的时候，调用该方法。 参数 child drawable状态发生变化的子视图 public abstract voidclearChildFocus(View child) 当子视图失去焦点的时候调用该方法。 参数 child 失去焦点的子视图 public abstract voidcreateContextMenu(ContextMenu menu) 如果该指定的ContextMenu需要增加菜单，则会由它的父类去填充（同时会向上递归）。 参数 menu 需要填充的菜单 public abstract ViewfocusSearch(View v, int direction) 在指定的方向找到最近的View来切换焦点。 参数 v 当前视图 direction FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT,与FOCUS_RIGHT中取值 public abstract voidfocusableViewAvailable(View v) 通知父类一个新的并且能够取得焦点的子视图可以使用了。用于处理从没有可取得焦点的视图到出现第一个可以取得焦点的视图的转变。 参数 v 新出现的可以取得焦点的视图 public abstract booleangetChildVisibleRect(View child, Rect r, Point offset) public abstractViewParentgetParent() 如果存在父视图，则返回该视图；否则返回NULL。 返回 如果不存在父视图，则返回null public abstract voidinvalidateChild(View child, Rect r) 重绘当前child指定的范围。 参数 child 当前视图 r child中无效的范围区域 public abstract ViewParentinvalidateChildInParent(int[]location, Rect r) 重绘当前child的全部或者一部分指定范围。location长度为的整形数组，两个数分别为child左边和上边的坐标。如果父视图中指定的区域r是无效的，则返回该ViewParent的父视图。如果父视图中指定区域是有效的或者父视图不存在，则返回null。如果方法返回对象不为空，则需要把location数组中的数值更新为返回的ViewParent的左边和上边的坐标值。 参数 location 长度为2的整形数组，数据为需要失效的child左边和上边的坐标值 r child中无效的范围区域 返回 ViewParent，如果不存在父视图，则返回null public abstract booleanisLayoutRequested() 返回该视图父类是否有layout控件被请求。 返回 true需要，false不需要 public abstract voidrecomputeViewAttributes(View child) 通知父类和子类所有的View属性需要重新生成。 参数 child 改变属性的View public abstract voidrequestChildFocus(View child, View focused) 当需要转换子类焦点时调用。 参数 child该ViewParent需要取得焦点的视图。该视图包含当前聚焦视图。但事实上也不一定会获得焦点 focused child的一个有焦点的子视图 public abstract booleanrequestChildRectangleOnScreen(View child, Rect rectangle, booleanimmediate) 当该child视图需要显示在屏幕特定位置时调用。ViewGroup如果需要重写该方法，可以遵循以下几点： *必须是该group的直接子类 *要是child中的坐标 ViewGroup要重写该方法，要坚持几下几点： *规定的区域已经是可见的，那么该方法将什么都不会改变 *区域可见时，该视图才会有滚动条 参数 child以起请求的直接子视图 rectangle需要显示到屏幕上的区域范围 immediate true禁止有滚动 false则有 返回值 处理请求操作后是否有滚动 public abstract voidrequestDisallowInterceptTouchEvent(boolean disallowIntercept) 让父类不用onInterceptTouchEvent(MotionEvent)来拦截触屏事件。 该父类需要把该方法传递给它的父类。同时也要服从触屏的请求（也就是说，只有在按上Up或者clear后才能清除该标识）。 参数 disallowIntercept true表示child触屏事件 public abstract voidrequestLayout() 当父视图的一个child的Layout控件失效时调用。该方法将会重新请求一个Layout控件。 public abstract voidrequestTransparentRegion(View child) 当一个child希望视图层去收集透明区域并报告给窗口排序服务时调用。例如SurfaceView可以用这个接口来提高接口性能。如果在当前层次没有视图，没有必要用该方法优化，否则有可能会轻微影响该层的性能。 参数 child要求透明区域进行处理的视图 public abstract booleanshowContextMenuForChild(View originalView) 显示该视图或者其祖先类的上下文菜单。 大多数情况下，子类不需要重写该方法。但是，当该子类被直接加到窗口管理器上时（例如：addView(View, android.view.ViewGroup.LayoutParams)），就会重写该方法，并显示上下文菜单。 参数 originalView需要显示上下文菜单的视图 返回 显示上下文菜单时返回true public abstract ActionModestartActionModeForChild(View originalView, ActionMode.Callback callback)Since: API Level 11 为指定视图启动一个操作模式。 大多数情况下，一个子类并不需要重新此类。但是，如果子类是直接添加到窗口管理器（例如，addView(View, android.view.ViewGroup.LayoutParams)），那么应重写此方法并启动操作模式。（译者注：关于ActionMode参见这里） 参数 originalView 操作模式首页调用的源视图 callback处理操作模式生命周期的回调函数 返回值 如果新的操作模式已经启动，返回该操作模式，否则返回 null 。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582380，如需转载请自行联系原作者
2017-11-06
优秀的个人博客,低调大师

Apache Storm 官方文档 —— 定义 Storm 的非 JVM 语言 DSL

实现非 JVM 语言 DSL（Domain Specific Language，领域专用语言）应该从storm-core/src/storm.thrift文件开始。由于 Storm 拓扑是 Thrift 结构，而且 Nimbus 是一个 Thrift 后台进程，你可以以任意语言创建并提交拓扑。 当你创建 Thrift 结构的 spouts 与 bolts 时，spout 或者 bolt 的代码是以 ComponentObject 结构体的形式定义的： union ComponentObject { 1: binary serialized_java; 2: ShellComponent shell; 3: JavaObject java_object; } 对于非 JVM 语言 DSL（这里以 Python DSL 为例），你需要使用其中的 “2” 与 “3”。ShellComponent 负责指定运行该组件（例如你的 python 代码）的脚本，而 JavaObject 则负责指定该组件的本地（native）Java spouts 与 bolts（而且 Storm 也会使用反射来创建 spout 或者 bolt）。 “storm shell” 命令可以用于提交拓扑。下面是一个示例： storm shell resources/ python topology.py arg1 arg2 Storm shell 随后会将resources/打包到一个 jar 文件中，将该文件上传到 Nimbus，然后像这样调用你的 topology.py 脚本： python topology.py arg1 arg2 {nimbus-host} {nimbus-port} {uploaded-jar-location} 接着你就可以使用 Thrift API 连接到 Nimbus 来提交拓扑，并将上传的 jar 文件地址作为参数传入 submitTopology 方法中。作为参考，下面给出了 submitTopology 的定义： void submitTopology(1: string name, 2: string uploadedJarLocation, 3: string jsonConf, 4: StormTopology topology) throws (1: AlreadyAliveException e, 2: InvalidTopologyException ite); 最后，对于非 JVM DSL 还有一件非常重要的事就是要确保可以在一个文件中方便地定义出完整的拓扑（bolts，spouts，以及拓扑的其他部分定义）。 转载自并发编程网 - ifeve.com
2017-05-21
优秀的个人博客,低调大师

《Spark 官方文档》Spark SQL, DataFrames 以及 Datasets 编程指南（三）

JSON数据集 Scala Java Python R Sql Spark SQL在加载JSON数据的时候，可以自动推导其schema并返回DataFrame。用SQLContext.read.json读取一个包含String的RDD或者JSON文件，即可实现这一转换。 注意，通常所说的json文件只是包含一些json数据的文件，而不是我们所需要的JSON格式文件。JSON格式文件必须每一行是一个独立、完整的的JSON对象。因此，一个常规的多行json文件经常会加载失败。 // sc是已有的SparkContext对象 val sqlContext = new org.apache.spark.sql.SQLContext(sc) // 数据集是由路径指定的 // 路径既可以是单个文件，也可以还是存储文本文件的目录 val path = "examples/src/main/resources/people.json" val people = sqlContext.read.json(path) // 推导出来的schema，可由printSchema打印出来 people.printSchema() // root // |-- age: integer (nullable = true) // |-- name: string (nullable = true) // 将DataFrame注册为table people.registerTempTable("people") // 跑SQL语句吧！ val teenagers = sqlContext.sql("SELECT name FROM people WHERE age >= 13 AND age <= 19") // 另一种方法是，用一个包含JSON字符串的RDD来创建DataFrame val anotherPeopleRDD = sc.parallelize( """{"name":"Yin","address":{"city":"Columbus","state":"Ohio"}}""" :: Nil) val anotherPeople = sqlContext.read.json(anotherPeopleRDD) Hive表 Spark SQL支持从Apache Hive读写数据。然而，Hive依赖项太多，所以没有把Hive包含在默认的Spark发布包里。要支持Hive，需要在编译spark的时候增加-Phive和-Phive-thriftserver标志。这样编译打包的时候将会把Hive也包含进来。注意，hive的jar包也必须出现在所有的worker节点上，访问Hive数据时候会用到（如：使用hive的序列化和反序列化SerDes时）。 Hive配置在conf/目录下hive-site.xml，core-site.xml（安全配置），hdfs-site.xml（HDFS配置）文件中。请注意，如果在YARN cluster（yarn-cluster mode）模式下执行一个查询的话，lib_mananged/jar/下面的datanucleus 的jar包，和conf/下的hive-site.xml必须在驱动器（driver）和所有执行器（executor）都可用。一种简便的方法是，通过spark-submit命令的–jars和–file选项来提交这些文件。 Scala Java Python R 如果使用Hive，则必须构建一个HiveContext，HiveContext是派生于SQLContext的，添加了在Hive Metastore里查询表的支持，以及对HiveQL的支持。用户没有现有的Hive部署，也可以创建一个HiveContext。如果没有在hive-site.xml里配置，那么HiveContext将会自动在当前目录下创建一个metastore_db目录，再根据HiveConf设置创建一个warehouse目录（默认/user/hive/warehourse）。所以请注意，你必须把/user/hive/warehouse的写权限赋予启动spark应用程序的用户。 // sc是一个已有的SparkContext对象 val sqlContext = new org.apache.spark.sql.hive.HiveContext(sc) sqlContext.sql("CREATE TABLE IF NOT EXISTS src (key INT, value STRING)") sqlContext.sql("LOAD DATA LOCAL INPATH 'examples/src/main/resources/kv1.txt' INTO TABLE src") // 这里用的是HiveQL sqlContext.sql("FROM src SELECT key, value").collect().foreach(println) 和不同版本的Hive Metastore交互 Spark SQL对Hive最重要的支持之一就是和Hive metastore进行交互，这使得Spark SQL可以访问Hive表的元数据。从Spark-1.4.0开始，Spark SQL有专门单独的二进制build版本，可以用来访问不同版本的Hive metastore，其配置表如下。注意，不管所访问的hive是什么版本，Spark SQL内部都是以Hive 1.2.1编译的，而且内部使用的Hive类也是基于这个版本（serdes，UDFs，UDAFs等） 以下选项可用来配置Hive版本以便访问其元数据： 属性名 默认值 含义 spark.sql.hive.metastore.version 1.2.1 Hive metastore版本，可选的值为0.12.0 到 1.2.1 spark.sql.hive.metastore.jars builtin 初始化HiveMetastoreClient的jar包。这个属性可以是以下三者之一： builtin 目前内建为使用Hive-1.2.1，编译的时候启用-Phive，则会和spark一起打包。如果没有-Phive，那么spark.sql.hive.metastore.version要么是1.2.1，要就是未定义 maven 使用maven仓库下载的jar包版本。这个选项建议不要再生产环境中使用 JVM格式的classpath。这个classpath必须包含所有Hive及其依赖的jar包，且包含正确版本的hadoop。这些jar包必须部署在driver节点上，如果你使用yarn-cluster模式，那么必须确保这些jar包也随你的应用程序一起打包 spark.sql.hive.metastore.sharedPrefixes com.mysql.jdbc, org.postgresql, com.microsoft.sqlserver, oracle.jdbc 一个逗号分隔的类名前缀列表，这些类使用classloader加载，且可以在Spark SQL和特定版本的Hive间共享。例如，用来访问hive metastore 的JDBC的driver就需要这种共享。其他需要共享的类，是与某些已经共享的类有交互的类。例如，自定义的log4j appender spark.sql.hive.metastore.barrierPrefixes (empty) 一个逗号分隔的类名前缀列表，这些类在每个Spark SQL所访问的Hive版本中都会被显式的reload。例如，某些在共享前缀列表（spark.sql.hive.metastore.sharedPrefixes）中声明为共享的Hive UD函数 用JDBC连接其他数据库 Spark SQL也可以用JDBC访问其他数据库。这一功能应该优先于使用JdbcRDD。因为它返回一个DataFrame，而DataFrame在Spark SQL中操作更简单，且更容易和来自其他数据源的数据进行交互关联。JDBC数据源在java和python中用起来也很简单，不需要用户提供额外的ClassTag。（注意，这与Spark SQL JDBC server不同，Spark SQLJDBC server允许其他应用执行Spark SQL查询） 首先，你需要在spark classpath中包含对应数据库的JDBC driver，下面这行包括了用于访问postgres的数据库driver SPARK_CLASSPATH=postgresql-9.3-1102-jdbc41.jar bin/spark-shell 远程数据库的表可以通过Data Sources API，用DataFrame或者SparkSQL 临时表来装载。以下是选项列表： 属性名 含义 url 需要连接的JDBC URL dbtable 需要读取的JDBC表。注意，任何可以填在SQL的where子句中的东西，都可以填在这里。（既可以填完整的表名，也可填括号括起来的子查询语句） driver JDBC driver的类名。这个类必须在master和worker节点上都可用，这样各个节点才能将driver注册到JDBC的子系统中。 partitionColumn, lowerBound, upperBound, numPartitions 这几个选项，如果指定其中一个，则必须全部指定。他们描述了多个worker如何并行的读入数据，并将表分区。partitionColumn必须是所查询的表中的一个数值字段。注意，lowerBound和upperBound只是用于决定分区跨度的，而不是过滤表中的行。因此，表中所有的行都会被分区然后返回。 fetchSize JDBC fetch size，决定每次获取多少行数据。在JDBC驱动上设成较小的值有利于性能优化（如，Oracle上设为10） Scala Java Python R Sql val jdbcDF = sqlContext.read.format("jdbc").options( Map("url" -> "jdbc:postgresql:dbserver", "dbtable" -> "schema.tablename")).load() 疑难解答 JDBC driver class必须在所有client session或者executor上，对java的原生classloader可见。这是因为Java的DriverManager在打开一个连接之前，会做安全检查，并忽略所有对原声classloader不可见的driver。最简单的一种方法，就是在所有worker节点上修改compute_classpath.sh，并包含你所需的driver jar包。 一些数据库，如H2，会把所有的名字转大写。对于这些数据库，在Spark SQL中必须也使用大写。 性能调整 对于有一定计算量的Spark作业来说，可能的性能改进的方式，不是把数据缓存在内存里，就是调整一些开销较大的选项参数。 内存缓存 Spark SQL可以通过调用SQLContext.cacheTable(“tableName”)或者DataFrame.cache()把tables以列存储格式缓存到内存中。随后，Spark SQL将会扫描必要的列，并自动调整压缩比例，以减少内存占用和GC压力。你也可以用SQLContext.uncacheTable(“tableName”)来删除内存中的table。 你还可以使用SQLContext.setConf 或在SQL语句中运行SET key=value命令，来配置内存中的缓存。 属性名 默认值 含义 spark.sql.inMemoryColumnarStorage.compressed true 如果设置为true，Spark SQL将会根据数据统计信息，自动为每一列选择单独的压缩编码方式。 spark.sql.inMemoryColumnarStorage.batchSize 10000 控制列式缓存批量的大小。增大批量大小可以提高内存利用率和压缩率，但同时也会带来OOM（Out Of Memory）的风险。 其他配置选项 以下选项同样也可以用来给查询任务调性能。不过这些选项在未来可能被放弃，因为spark将支持越来越多的自动优化。 属性名 默认值 含义 spark.sql.autoBroadcastJoinThreshold 10485760 (10 MB) 配置join操作时，能够作为广播变量的最大table的大小。设置为-1，表示禁用广播。注意，目前的元数据统计仅支持Hive metastore中的表，并且需要运行这个命令：ANALYSE TABLE <tableName> COMPUTE STATISTICS noscan spark.sql.tungsten.enabled true 设为true，则启用优化的Tungsten物理执行后端。Tungsten会显式的管理内存，并动态生成表达式求值的字节码 spark.sql.shuffle.partitions 200 配置数据混洗（shuffle）时（join或者聚合操作），使用的分区数。 分布式SQL引擎 Spark SQL可以作为JDBC/ODBC或者命令行工具的分布式查询引擎。在这种模式下，终端用户或应用程序，无需写任何代码，就可以直接在Spark SQL中运行SQL查询。 运行Thrift JDBC/ODBC server 这里实现的Thrift JDBC/ODBC server和Hive-1.2.1中的HiveServer2是相同的。你可以使用beeline脚本来测试Spark或者Hive-1.2.1的JDBC server。 在Spark目录下运行下面这个命令，启动一个JDBC/ODBC server ./sbin/start-thriftserver.sh 这个脚本能接受所有 bin/spark-submit 命令支持的选项参数，外加一个 –hiveconf 选项，来指定Hive属性。运行./sbin/start-thriftserver.sh –help可以查看完整的选项列表。默认情况下，启动的server将会在localhost:10000端口上监听。要改变监听主机名或端口，可以用以下环境变量： export HIVE_SERVER2_THRIFT_PORT=<listening-port> export HIVE_SERVER2_THRIFT_BIND_HOST=<listening-host> ./sbin/start-thriftserver.sh \ --master <master-uri> \ ... 或者Hive系统属性 来指定 ./sbin/start-thriftserver.sh \ --hiveconf hive.server2.thrift.port=<listening-port> \ --hiveconf hive.server2.thrift.bind.host=<listening-host> \ --master <master-uri> ... 接下来，你就可以开始在beeline中测试这个Thrift JDBC/ODBC server: ./bin/beeline 下面的指令，可以连接到一个JDBC/ODBC server beeline> !connect jdbc:hive2://localhost:10000 可能需要输入用户名和密码。在非安全模式下，只要输入你本机的用户名和一个空密码即可。对于安全模式，请参考beeline documentation. Hive的配置是在conf/目录下的hive-site.xml，core-site.xml，hdfs-site.xml中指定的。 你也可以在beeline的脚本中指定。 Thrift JDBC server也支持通过HTTP传输Thrift RPC消息。以下配置（在conf/hive-site.xml中）将启用HTTP模式： hive.server2.transport.mode - Set this to value: http hive.server2.thrift.http.port - HTTP port number fo listen on; default is 10001 hive.server2.http.endpoint - HTTP endpoint; default is cliservice 同样，在beeline中也可以用HTTP模式连接JDBC/ODBC server: beeline> !connect jdbc:hive2://<host>:<port>/<database>?hive.server2.transport.mode=http;hive.server2.thrift.http.path=<http_endpoint> 转载自 并发编程网 - ifeve.com
2017-05-18

资源下载

更多资源
Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

时间: 2026-10-18 大小: 211.28KB 下载: 56次
Spring

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

时间: 2026-08-21 大小: 5MB 下载: 2次
Sublime Text

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。

时间: 2026-08-21 大小: 9.84MB 下载: 40次
WebStorm

WebStorm

WebStorm 是jetbrains公司旗下一款JavaScript 开发工具。目前已经被广大中国JS开发者誉为“Web前端开发神器”、“最强大的HTML5编辑器”、“最智能的JavaScript IDE”等。与IntelliJ IDEA同源，继承了IntelliJ IDEA强大的JS部分的功能。

时间: 2025-12-13 大小: 249.54MB 下载: 22次
热门标签
DeepSeek Jdk25 OpenAi HarmonyOS6 Nacos3 SpringBoot4 SpringCloud Docker Kubernetes Service Mesh Redis Gemini3 Rocky

欢迎您来访！

登录后，您将获得更多功能！
热门文章
联系我们

有任何问题或合作意向欢迎联系我们

Email: 99873273@qq.com

QQ: 99873273

用户登录
用户注册