Updated interface

Author: macuser

codeview/src/main/java/io/github/kbiakov/codeview/CodeView.kt

@@ -9,115 +9,68 @@ import android.widget.RelativeLayout
 import io.github.kbiakov.codeview.Thread.delayed
 import io.github.kbiakov.codeview.adapters.AbstractCodeAdapter
 import io.github.kbiakov.codeview.adapters.CodeWithNotesAdapter
+import io.github.kbiakov.codeview.adapters.Options
 
 /**
  * @class CodeView
  *
- * Presents your code content.
- *
- * Before view built or started to, as the first step, placeholder
- * measures & prepare place for code view. Amount of view params is
- * not big, view has mutable state & non-standard initialization behavior.
- * That is why there is no usual & well-known Builder pattern implementation.
- *
- * To control interaction state, being & built, was selected tasks queue.
- * If user has already built view his task performs immediately, otherwise
- * it puts in queue to awaiting adapter creation & processing by build flow.
- * This helps to avoid errors & solve the init tasks in more elegant way.
+ * View for showing code content with syntax highlighting.
  *
  * @author Kirill Biakov
  */
-open class CodeView : RelativeLayout {
+class CodeView(context: Context, attrs: AttributeSet) : RelativeLayout(context, attrs) {
 
     private val vShadowRight: View
     private val vShadowBottomLine: View
     private val vShadowBottomContent: View
 
-    /**
-     * Core view to draw code by lines.
-     */
     private val vCodeList: RecyclerView
 
-    fun getRecyclerView(): RecyclerView {
-        return vCodeList
-    }
-
     /**
-     * Default constructor.
+     * Primary constructor.
      */
-    constructor(context: Context, attrs: AttributeSet) : super(context, attrs) {
-        val defaultAlpha = 0.7531f
-        var animateOnStart = true
-
-        val a = context.theme.obtainStyledAttributes(attrs, R.styleable.CodeView, 0, 0)
-        try {
-            animateOnStart = a.getBoolean(R.styleable.CodeView_animateOnStart, animateOnStart)
-        } finally {
-            a.recycle()
-        }
-        animateOnStart = animateOnStart && visibility == View.VISIBLE
+    init {
+        val isAnimateOnStart = visibility == VISIBLE && { ctx: Context, ats: AttributeSet ->
+            val a = ctx.theme.obtainStyledAttributes(ats, R.styleable.CodeView, 0, 0)
+
+            try {
+                a.getBoolean(R.styleable.CodeView_animateOnStart, true)
+            } finally {
+                a.recycle()
+            }
+        }(context, attrs)
 
-        alpha = if (animateOnStart) 0f else defaultAlpha
+        alpha = if (isAnimateOnStart) 0f else Consts.ALPHA
 
         inflate(context, R.layout.layout_code_view, this)
 
-        if (animateOnStart) {
-            animate().setDuration(Utils.DELAY * 5)
-                    .alpha(defaultAlpha)
-        }
+        if (isAnimateOnStart)
+            animate().setDuration(Consts.DELAY * 5)
+                    .alpha(Consts.ALPHA)
 
-        vShadowRight = findViewById(R.id.v_shadow_right)//todo: shadow color customization
-        vShadowBottomLine = findViewById(R.id.v_shadow_bottom_line)//todo: shadow color customization
-        vShadowBottomContent = findViewById(R.id.v_shadow_bottom_content)//todo: shadow color customization
+        // TODO: add shadow color customization
+        vShadowRight = findViewById(R.id.v_shadow_right)
+        vShadowBottomLine = findViewById(R.id.v_shadow_bottom_line)
+        vShadowBottomContent = findViewById(R.id.v_shadow_bottom_content)
 
         vCodeList = findViewById(R.id.rv_code_content) as RecyclerView
         vCodeList.layoutManager = LinearLayoutManager(context)
         vCodeList.isNestedScrollingEnabled = true
     }
 
     /**
-     * Initialize RecyclerView with adapter
-     * then start highlighting
-     */
-    fun init(h: Highlighter, adapter: AbstractCodeAdapter<*>) {
-        if (h.code.isEmpty()) {
-            throw IllegalStateException("Please set code() before init/highlight")
-        }
-
-        vCodeList.adapter = adapter
-
-        setupShadows(adapter.highlighter.shadows)
-
-        highlight()
-    }
-
-    /**
-     * Initialize RecyclerView with adapter
-     * then start highlighting
-     */
-    fun init(adapter: AbstractCodeAdapter<*>) {
-        init(adapter.highlighter, adapter)
-    }
-
-    /**
-     * Initialize RecyclerView with adapter
-     * then start highlighting
+     * Code adapter accessor.
      */
-    fun init(h: Highlighter) {
-        init(h, CodeWithNotesAdapter(context, h))
-    }
+    private fun getAdapter() = vCodeList.adapter as? AbstractCodeAdapter<*>
 
     /**
      * Highlight code by defined programming language.
-     * It holds the placeholder on the view until code is highlighted.
+     * It holds the placeholder on the view until code is not highlighted.
      */
-    fun highlight() {
-        if (vCodeList.adapter == null) {
-            throw IllegalStateException("Please set adapter or use init(highlighter) before highlight()")
-        }
+    private fun highlight() {
+        getAdapter()?.highlight {
 
-        getAdapter()?.highlight() {
-            animate().setDuration(Utils.DELAY * 2)
+            animate().setDuration(Consts.DELAY * 2)
                     .alpha(.1f)
 
             delayed {
@@ -128,45 +81,72 @@ open class CodeView : RelativeLayout {
     }
 
     /**
-     * Remove code listener.
+     * Border shadows will shown if presented full code listing.
+     * It helps to see what part of code is scrolled & hidden.
+     *
+     * @param isShadows Is shadows needed
      */
-    fun removeLineClickListener() {
-        getAdapter()?.highlighter?.lineClickListener = null
-    }
+    private fun setupShadows(isShadows: Boolean) {
+        val visibility = if (isShadows) VISIBLE else GONE
 
-    fun getAdapter() = vCodeList.adapter as? AbstractCodeAdapter<*>
+        vShadowRight.visibility = visibility
+        vShadowBottomLine.visibility = visibility
+        vShadowBottomContent.visibility = visibility
+    }
 
     /**
-     * Update code.
+     * Prepare view with default adapter & options.
      */
-    fun update(code: String) {
-        getAdapter()?.updateCode(code)
+    private fun prepare() {
+        setAdapter(CodeWithNotesAdapter(context))
     }
 
     /**
-     * Update code.
+     * Initialize with options.
+     *
+     * @param opts Options
      */
-    fun update(h: Highlighter) {
-        init(getAdapter()!!.highlighter.update(h))
+    fun setOptions(opts: Options) {
+        setAdapter(CodeWithNotesAdapter(context, opts))
     }
 
-    // - Setup actions
+    /**
+     * Initialize with adapter.
+     *
+     * @param adapter Adapter
+     */
+    fun setAdapter(adapter: AbstractCodeAdapter<*>) {
+        vCodeList.adapter = adapter
+        setupShadows(adapter.opts.shadows)
+        highlight()
+    }
 
     /**
-     * Border shadows will shown if presented full code listing.
-     * It helps user to see what part of code are scrolled & hidden.
+     * Set code content.
+     * At this point view should be prepared, otherwise it
+     * will be configured automatically with default params.
+     *
+     * @param code Code content
      */
-    private fun setupShadows(shadows: Boolean) {
-        val visibility = if (shadows) VISIBLE else GONE
+    fun setCode(code: String) {
+        getAdapter() ?: prepare()
+        getAdapter()?.updateCode(code)
+    }
 
-        vShadowRight.visibility = visibility
-        vShadowBottomLine.visibility = visibility
-        vShadowBottomContent.visibility = visibility
+    /**
+     * Set code content.
+     *
+     * @param code Code content
+     * @param language Programming language
+     */
+    fun setCode(code: String, language: String) {
+        getAdapter() ?: setOptions(Options(context, language = language))
+        getAdapter()?.updateCode(code)
     }
 }
 
 /**
- * Provides listener to code line clicks.
+ * Provide listener to code line clicks.
  */
 interface OnCodeLineClickListener {
     fun onLineClicked(n: Int, line: String)