typeAdapter(Gson gson) {
53 | return new AutoValue_User.GsonTypeAdapter(gson);
54 | }
55 | }
56 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # This project is deprecated
2 |
3 | It will still be maintained, but no new features will be added. Please use [Parcelize](https://kotlinlang.org/docs/tutorials/android-plugin.html#parcelable-implementations-generator), as it is the official way of generating `Parcelable` implementations on Android.
4 |
5 | # PaperParcel
6 |
7 | [](https://travis-ci.org/grandstaish/paperparcel)
8 |
9 | PaperParcel is an annotation processor that automatically generates the `CREATOR` and `writeToParcel(...)` implementations for you when writing [Parcelable](http://developer.android.com/intl/es/reference/android/os/Parcelable.html) objects. PaperParcel fully supports both Java and Kotlin (including [Kotlin Data Classes](https://kotlinlang.org/docs/reference/data-classes.html)). Additionally, PaperParcel supports Google's [AutoValue](https://github.com/google/auto/tree/master/value) via an [AutoValue Extension](http://jakewharton.com/presentation/2016-03-08-ny-android-meetup/).
10 |
11 | For more information please see [the website](http://grandstaish.github.io/paperparcel/).
12 |
13 | ## Download
14 |
15 | **Java:**
16 |
17 | ```groovy
18 | dependencies {
19 | compile 'nz.bradcampbell:paperparcel:2.0.8'
20 | annotationProcessor 'nz.bradcampbell:paperparcel-compiler:2.0.8'
21 | }
22 | ```
23 |
24 | **Kotlin:**
25 | ```groovy
26 | apply plugin: 'kotlin-kapt'
27 |
28 | dependencies {
29 | compile 'nz.bradcampbell:paperparcel:2.0.8'
30 | compile 'nz.bradcampbell:paperparcel-kotlin:2.0.8' // Optional
31 | kapt 'nz.bradcampbell:paperparcel-compiler:2.0.8'
32 | }
33 | ```
34 |
35 | Development snapshots are available on [JFrog OSS Artifactory](https://oss.jfrog.org/oss-snapshot-local).
36 |
37 | ## License
38 | Copyright 2016 Bradley Campbell.
39 |
40 | Licensed under the Apache License, Version 2.0 (the "License");
41 | you may not use this file except in compliance with the License.
42 | You may obtain a copy of the License at
43 |
44 | http://www.apache.org/licenses/LICENSE-2.0
45 |
46 | Unless required by applicable law or agreed to in writing, software
47 | distributed under the License is distributed on an "AS IS" BASIS,
48 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
49 | See the License for the specific language governing permissions and
50 | limitations under the License.
51 |
--------------------------------------------------------------------------------
/examples/benchmark-demo/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: 'com.android.application'
2 |
3 | android {
4 | compileSdkVersion rootProject.ext.compileSdkVersion
5 | buildToolsVersion rootProject.ext.buildToolsVersion
6 |
7 | defaultConfig {
8 | applicationId "nz.bradcampbell.benchmarkdemo"
9 | minSdkVersion 11
10 | targetSdkVersion rootProject.ext.targetSdkVersion
11 | versionCode 1
12 | versionName "1.0"
13 | }
14 |
15 | buildTypes {
16 | release {
17 | signingConfig signingConfigs.debug
18 | minifyEnabled true
19 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
20 | }
21 | }
22 |
23 | compileOptions {
24 | sourceCompatibility rootProject.ext.sourceCompatibilityVersion
25 | targetCompatibility rootProject.ext.targetCompatibilityVersion
26 | }
27 | }
28 |
29 | repositories {
30 | mavenCentral()
31 | jcenter()
32 | maven { url "https://clojars.org/repo/" }
33 | }
34 |
35 | dependencies {
36 | compile deps.supportAnnotations
37 | compile deps.appCompat
38 |
39 | // PaperParcel
40 | compile project(':paperparcel')
41 | // The PaperParcel processor with the AutoValueExtension removed so that it can be compared with
42 | // other AutoValue extensions that set "mustBeFinal" to true.
43 | annotationProcessor files('libs/paperparcel-compiler-no-autovalue.jar')
44 | // Missing transitive dependencies from the no-autovalue jar.
45 | annotationProcessor deps.javaFormat
46 | annotationProcessor deps.autocommon
47 |
48 | // Gson for parsing json (can't use LoganSquare because we need to parse auto-value objects)
49 | compile 'com.google.code.gson:gson:2.8.0'
50 | annotationProcessor 'com.ryanharter.auto.value:auto-value-gson:0.4.4'
51 | provided 'com.ryanharter.auto.value:auto-value-gson:0.4.4'
52 |
53 | // Parceler for comparison
54 | compile 'org.parceler:parceler-api:1.1.6'
55 | annotationProcessor 'org.parceler:parceler:1.1.6'
56 |
57 | // AutoValue for AutoValue extension based libraries
58 | provided deps.autovalue
59 | annotationProcessor deps.autovalue
60 |
61 | // AutoValue: Parcel Extension for comparison
62 | annotationProcessor 'com.ryanharter.auto.value:auto-value-parcel:0.2.5'
63 |
64 | // Can't compare with AutoParcel because that isn't even up to date with AutoValue =/
65 | // If it ever gets updated, I'll have to comment out ryan harter's version to test it as
66 | // they both set "mustBeFinal" to true.
67 | // annotationProcessor 'frankiesardo:auto-parcel:1.0.3'
68 | }
69 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/SourceFileGenerationException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2014 The Dagger Authors.
3 | * Modifications copyright (C) 2016 Bradley Campbell.
4 | *
5 | * Licensed under the Apache License, Version 2.0 (the "License");
6 | * you may not use this file except in compliance with the License.
7 | * You may obtain a copy of the License at
8 | *
9 | * http://www.apache.org/licenses/LICENSE-2.0
10 | *
11 | * Unless required by applicable law or agreed to in writing, software
12 | * distributed under the License is distributed on an "AS IS" BASIS,
13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 | * See the License for the specific language governing permissions and
15 | * limitations under the License.
16 | */
17 |
18 | package paperparcel;
19 |
20 | import com.google.common.base.Optional;
21 | import com.squareup.javapoet.ClassName;
22 | import javax.annotation.processing.Messager;
23 | import javax.lang.model.element.Element;
24 |
25 | import static com.google.common.base.Preconditions.checkNotNull;
26 | import static javax.tools.Diagnostic.Kind.ERROR;
27 |
28 | /**
29 | * An exception thrown to indicate that a source file could not be generated.
30 | *
31 | * This exception should not be used to report detectable, logical errors as it may mask
32 | * other errors that might have been caught upon further processing. Use a {@link
33 | * ValidationReport}
34 | * for that.
35 | */
36 | final class SourceFileGenerationException extends Exception {
37 | private final Optional associatedElement;
38 |
39 | SourceFileGenerationException(
40 | Optional generatedClassName,
41 | Throwable cause,
42 | Optional associatedElement) {
43 | super(createMessage(generatedClassName, cause.getMessage()), cause);
44 | this.associatedElement = checkNotNull(associatedElement);
45 | }
46 |
47 | private static String createMessage(Optional generatedClassName, String message) {
48 | return String.format("Could not generate %s: %s.",
49 | generatedClassName.isPresent()
50 | ? generatedClassName.get()
51 | : "unknown file",
52 | message);
53 | }
54 |
55 | void printMessageTo(Messager messager) {
56 | if (associatedElement.isPresent()) {
57 | messager.printMessage(ERROR, getMessage(), associatedElement.get());
58 | } else {
59 | messager.printMessage(ERROR, getMessage());
60 | }
61 | }
62 | }
63 |
--------------------------------------------------------------------------------
/examples/kotlin-example/src/main/kotlin/nz/bradcampbell/kotlinexample/MainActivity.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package nz.bradcampbell.kotlinexample
18 |
19 | import android.annotation.SuppressLint
20 | import android.os.Bundle
21 | import android.view.View
22 | import android.widget.TextView
23 | import androidx.appcompat.app.AppCompatActivity
24 | import androidx.appcompat.widget.Toolbar
25 | import java.text.SimpleDateFormat
26 | import java.util.Date
27 | import java.util.Locale
28 |
29 | class MainActivity : AppCompatActivity() {
30 | private var state = State(0, Date())
31 | private val dateFormat = SimpleDateFormat("HH:mm", Locale.ENGLISH)
32 |
33 | override fun onCreate(savedInstanceState: Bundle?) {
34 | super.onCreate(savedInstanceState)
35 | setContentView(R.layout.activity_main)
36 |
37 | savedInstanceState?.let {
38 | state = it.getParcelable("state")
39 | }
40 |
41 | val toolbar = findViewById(R.id.toolbar)
42 | setSupportActionBar(toolbar)
43 |
44 | val plusButton = findViewById(R.id.add_button)
45 | plusButton.setOnClickListener {
46 | state = state.copy(count = state.count + 1, modificationDate = Date())
47 | updateText()
48 | }
49 |
50 | val subtractButton = findViewById(R.id.subtract_button)
51 | subtractButton.setOnClickListener {
52 | state = state.copy(count = state.count - 1, modificationDate = Date())
53 | updateText()
54 | }
55 |
56 | updateText()
57 | }
58 |
59 | override fun onSaveInstanceState(outState: Bundle) {
60 | super.onSaveInstanceState(outState)
61 | outState.putParcelable("state", state)
62 | }
63 |
64 | @SuppressLint("SetTextI18n")
65 | private fun updateText() {
66 | val counter = findViewById(R.id.counter)
67 | counter.text = "${state.count} (updated at ${dateFormat.format(state.modificationDate)})"
68 | }
69 | }
70 |
--------------------------------------------------------------------------------
/docs/javascripts/jquery.smooth-scroll.min.js:
--------------------------------------------------------------------------------
1 | /*!
2 | * Smooth Scroll - v1.4.10 - 2013-03-02
3 | * https://github.com/kswedberg/jquery-smooth-scroll
4 | * Copyright (c) 2013 Karl Swedberg
5 | * Licensed MIT (https://github.com/kswedberg/jquery-smooth-scroll/blob/master/LICENSE-MIT)
6 | */
7 | (function(l){function t(l){return l.replace(/(:|\.)/g,"\\$1")}var e="1.4.10",o={exclude:[],excludeWithin:[],offset:0,direction:"top",scrollElement:null,scrollTarget:null,beforeScroll:function(){},afterScroll:function(){},easing:"swing",speed:400,autoCoefficent:2},r=function(t){var e=[],o=!1,r=t.dir&&"left"==t.dir?"scrollLeft":"scrollTop";return this.each(function(){if(this!=document&&this!=window){var t=l(this);t[r]()>0?e.push(this):(t[r](1),o=t[r]()>0,o&&e.push(this),t[r](0))}}),e.length||this.each(function(){"BODY"===this.nodeName&&(e=[this])}),"first"===t.el&&e.length>1&&(e=[e[0]]),e};l.fn.extend({scrollable:function(l){var t=r.call(this,{dir:l});return this.pushStack(t)},firstScrollable:function(l){var t=r.call(this,{el:"first",dir:l});return this.pushStack(t)},smoothScroll:function(e){e=e||{};var o=l.extend({},l.fn.smoothScroll.defaults,e),r=l.smoothScroll.filterPath(location.pathname);return this.unbind("click.smoothscroll").bind("click.smoothscroll",function(e){var n=this,s=l(this),c=o.exclude,i=o.excludeWithin,a=0,f=0,h=!0,u={},d=location.hostname===n.hostname||!n.hostname,m=o.scrollTarget||(l.smoothScroll.filterPath(n.pathname)||r)===r,p=t(n.hash);if(o.scrollTarget||d&&m&&p){for(;h&&c.length>a;)s.is(t(c[a++]))&&(h=!1);for(;h&&i.length>f;)s.closest(i[f++]).length&&(h=!1)}else h=!1;h&&(e.preventDefault(),l.extend(u,o,{scrollTarget:o.scrollTarget||p,link:n}),l.smoothScroll(u))}),this}}),l.smoothScroll=function(t,e){var o,r,n,s,c=0,i="offset",a="scrollTop",f={},h={};"number"==typeof t?(o=l.fn.smoothScroll.defaults,n=t):(o=l.extend({},l.fn.smoothScroll.defaults,t||{}),o.scrollElement&&(i="position","static"==o.scrollElement.css("position")&&o.scrollElement.css("position","relative"))),o=l.extend({link:null},o),a="left"==o.direction?"scrollLeft":a,o.scrollElement?(r=o.scrollElement,c=r[a]()):r=l("html, body").firstScrollable(),o.beforeScroll.call(r,o),n="number"==typeof t?t:e||l(o.scrollTarget)[i]()&&l(o.scrollTarget)[i]()[o.direction]||0,f[a]=n+c+o.offset,s=o.speed,"auto"===s&&(s=f[a]||r.scrollTop(),s/=o.autoCoefficent),h={duration:s,easing:o.easing,complete:function(){o.afterScroll.call(o.link,o)}},o.step&&(h.step=o.step),r.length?r.stop().animate(f,h):o.afterScroll.call(o.link,o)},l.smoothScroll.version=e,l.smoothScroll.filterPath=function(l){return l.replace(/^\//,"").replace(/(index|default).[a-zA-Z]{3,4}$/,"").replace(/\/$/,"")},l.fn.smoothScroll.defaults=o})(jQuery);
8 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/OptionsProcessingStep.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package paperparcel;
18 |
19 | import com.google.auto.common.BasicAnnotationProcessor;
20 | import com.google.common.collect.ImmutableSet;
21 | import com.google.common.collect.SetMultimap;
22 | import java.lang.annotation.Annotation;
23 | import java.util.Set;
24 | import javax.annotation.processing.Messager;
25 | import javax.lang.model.element.AnnotationMirror;
26 | import javax.lang.model.element.Element;
27 | import javax.tools.Diagnostic;
28 |
29 | import static com.google.auto.common.MoreElements.getAnnotationMirror;
30 |
31 | /**
32 | * Extracts global {@link OptionsDescriptor} to be used for processing and stores it in
33 | */
34 | final class OptionsProcessingStep implements BasicAnnotationProcessor.ProcessingStep {
35 | private final Messager messager;
36 | private final OptionsHolder optionsHolder;
37 |
38 | OptionsProcessingStep(
39 | Messager messager,
40 | OptionsHolder optionsHolder) {
41 | this.messager = messager;
42 | this.optionsHolder = optionsHolder;
43 | }
44 |
45 | @Override public Set> annotations() {
46 | return ImmutableSet.of(ProcessorConfig.class);
47 | }
48 |
49 | @Override public Set process(
50 | SetMultimap, Element> elementsByAnnotation) {
51 | Set processorConfigElements = elementsByAnnotation.get(ProcessorConfig.class);
52 | if (optionsHolder.isOptionsApplied() || processorConfigElements.size() > 1) {
53 | messager.printMessage(Diagnostic.Kind.ERROR, ErrorMessages.MULTIPLE_PROCESSOR_CONFIGS);
54 | } else if (processorConfigElements.size() == 1) {
55 | Element configElement = processorConfigElements.iterator().next();
56 | AnnotationMirror config = getAnnotationMirror(configElement, ProcessorConfig.class).get();
57 | optionsHolder.setOptions(Utils.getModuleOptions(config));
58 | }
59 | return ImmutableSet.of();
60 | }
61 | }
62 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @if "%DEBUG%" == "" @echo off
2 | @rem ##########################################################################
3 | @rem
4 | @rem Gradle startup script for Windows
5 | @rem
6 | @rem ##########################################################################
7 |
8 | @rem Set local scope for the variables with windows NT shell
9 | if "%OS%"=="Windows_NT" setlocal
10 |
11 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
12 | set DEFAULT_JVM_OPTS=
13 |
14 | set DIRNAME=%~dp0
15 | if "%DIRNAME%" == "" set DIRNAME=.
16 | set APP_BASE_NAME=%~n0
17 | set APP_HOME=%DIRNAME%
18 |
19 | @rem Find java.exe
20 | if defined JAVA_HOME goto findJavaFromJavaHome
21 |
22 | set JAVA_EXE=java.exe
23 | %JAVA_EXE% -version >NUL 2>&1
24 | if "%ERRORLEVEL%" == "0" goto init
25 |
26 | echo.
27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
28 | echo.
29 | echo Please set the JAVA_HOME variable in your environment to match the
30 | echo location of your Java installation.
31 |
32 | goto fail
33 |
34 | :findJavaFromJavaHome
35 | set JAVA_HOME=%JAVA_HOME:"=%
36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
37 |
38 | if exist "%JAVA_EXE%" goto init
39 |
40 | echo.
41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
42 | echo.
43 | echo Please set the JAVA_HOME variable in your environment to match the
44 | echo location of your Java installation.
45 |
46 | goto fail
47 |
48 | :init
49 | @rem Get command-line arguments, handling Windowz variants
50 |
51 | if not "%OS%" == "Windows_NT" goto win9xME_args
52 | if "%@eval[2+2]" == "4" goto 4NT_args
53 |
54 | :win9xME_args
55 | @rem Slurp the command line arguments.
56 | set CMD_LINE_ARGS=
57 | set _SKIP=2
58 |
59 | :win9xME_args_slurp
60 | if "x%~1" == "x" goto execute
61 |
62 | set CMD_LINE_ARGS=%*
63 | goto execute
64 |
65 | :4NT_args
66 | @rem Get arguments from the 4NT Shell from JP Software
67 | set CMD_LINE_ARGS=%$
68 |
69 | :execute
70 | @rem Setup the command line
71 |
72 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
73 |
74 | @rem Execute Gradle
75 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
76 |
77 | :end
78 | @rem End local scope for the variables with windows NT shell
79 | if "%ERRORLEVEL%"=="0" goto mainEnd
80 |
81 | :fail
82 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
83 | rem the _cmd.exe /c_ return code!
84 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
85 | exit /b 1
86 |
87 | :mainEnd
88 | if "%OS%"=="Windows_NT" endlocal
89 |
90 | :omega
91 |
--------------------------------------------------------------------------------
/examples/java7-example/src/main/java/nz/bradcampbell/java7example/MainActivity.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package nz.bradcampbell.java7example;
18 |
19 | import android.os.Bundle;
20 | import android.support.v7.app.AppCompatActivity;
21 | import android.support.v7.widget.Toolbar;
22 | import android.view.View;
23 | import android.widget.TextView;
24 |
25 | import java.text.DateFormat;
26 | import java.text.SimpleDateFormat;
27 | import java.util.Date;
28 | import java.util.Locale;
29 |
30 | import androidx.annotation.Nullable;
31 |
32 | public class MainActivity extends AppCompatActivity {
33 | private State state = new State(0);
34 | private final DateFormat dateFormat = new SimpleDateFormat("HH:mm", Locale.getDefault());
35 |
36 | @Override protected void onCreate(@Nullable Bundle savedInstanceState) {
37 | super.onCreate(savedInstanceState);
38 | setContentView(R.layout.activity_main);
39 |
40 | if (savedInstanceState != null) {
41 | state = savedInstanceState.getParcelable("state");
42 | }
43 |
44 | Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
45 | setSupportActionBar(toolbar);
46 |
47 | View plusButton = findViewById(R.id.add_button);
48 | plusButton.setOnClickListener(new View.OnClickListener() {
49 | @Override public void onClick(View v) {
50 | state = new State(state.getCount() + 1);
51 | updateText();
52 | }
53 | });
54 |
55 | View subtractButton = findViewById(R.id.subtract_button);
56 | subtractButton.setOnClickListener(new View.OnClickListener() {
57 | @Override public void onClick(View v) {
58 | state = new State(state.getCount() - 1);
59 | updateText();
60 | }
61 | });
62 |
63 | updateText();
64 | }
65 |
66 | private void updateText() {
67 | state.modificationDate = new Date();
68 | TextView counter = (TextView) findViewById(R.id.counter);
69 | counter.setText(
70 | state.getCount() + " (updated at " + dateFormat.format(state.modificationDate) + ")");
71 | }
72 |
73 | @Override protected void onSaveInstanceState(Bundle outState) {
74 | super.onSaveInstanceState(outState);
75 | outState.putParcelable("state", state);
76 | }
77 | }
78 |
--------------------------------------------------------------------------------
/examples/java7-lombok-example/src/main/java/nz/bradcampbell/java7example/MainActivity.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package nz.bradcampbell.java7example;
18 |
19 | import android.os.Bundle;
20 | import android.support.v7.app.AppCompatActivity;
21 | import android.support.v7.widget.Toolbar;
22 | import android.view.View;
23 | import android.widget.TextView;
24 |
25 | import java.text.DateFormat;
26 | import java.text.SimpleDateFormat;
27 | import java.util.Date;
28 | import java.util.Locale;
29 |
30 | import androidx.annotation.Nullable;
31 |
32 | public class MainActivity extends AppCompatActivity {
33 | private State state = new State(0);
34 | private final DateFormat dateFormat = new SimpleDateFormat("HH:mm", Locale.getDefault());
35 |
36 | @Override protected void onCreate(@Nullable Bundle savedInstanceState) {
37 | super.onCreate(savedInstanceState);
38 | setContentView(R.layout.activity_main);
39 |
40 | if (savedInstanceState != null) {
41 | state = savedInstanceState.getParcelable("state");
42 | }
43 |
44 | Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
45 | setSupportActionBar(toolbar);
46 |
47 | View plusButton = findViewById(R.id.add_button);
48 | plusButton.setOnClickListener(new View.OnClickListener() {
49 | @Override public void onClick(View v) {
50 | state = new State(state.getCount() + 1);
51 | updateText();
52 | }
53 | });
54 |
55 | View subtractButton = findViewById(R.id.subtract_button);
56 | subtractButton.setOnClickListener(new View.OnClickListener() {
57 | @Override public void onClick(View v) {
58 | state = new State(state.getCount() - 1);
59 | updateText();
60 | }
61 | });
62 |
63 | updateText();
64 | }
65 |
66 | private void updateText() {
67 | state.setModificationDate(new Date());
68 | TextView counter = (TextView) findViewById(R.id.counter);
69 | counter.setText(
70 | state.getCount() + " (updated at " + dateFormat.format(state.getModificationDate()) + ")");
71 | }
72 |
73 | @Override protected void onSaveInstanceState(Bundle outState) {
74 | super.onSaveInstanceState(outState);
75 | outState.putParcelable("state", state);
76 | }
77 | }
78 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/OptionsDescriptor.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package paperparcel;
18 |
19 | import com.google.auto.value.AutoValue;
20 | import com.google.common.collect.ImmutableList;
21 | import com.google.common.collect.ImmutableSet;
22 |
23 | import java.util.Set;
24 |
25 | import javax.lang.model.element.AnnotationMirror;
26 | import javax.lang.model.element.Modifier;
27 |
28 | import androidx.annotation.Nullable;
29 |
30 | import static javax.lang.model.element.Modifier.STATIC;
31 | import static javax.lang.model.element.Modifier.TRANSIENT;
32 |
33 | /** Describes the options relevant to parsing a {@link PaperParcel} class. */
34 | @AutoValue
35 | abstract class OptionsDescriptor {
36 | static final OptionsDescriptor DEFAULT = create(
37 | null,
38 | ImmutableList.>of(ImmutableSet.of(STATIC), ImmutableSet.of(TRANSIENT)),
39 | ImmutableList.of(),
40 | ImmutableList.of(),
41 | false,
42 | ImmutableList.of(),
43 | true,
44 | false);
45 |
46 | @Nullable abstract AnnotationMirror mirror();
47 |
48 | abstract ImmutableList> excludeModifiers();
49 |
50 | abstract ImmutableList excludeAnnotationNames();
51 |
52 | abstract ImmutableList exposeAnnotationNames();
53 |
54 | abstract boolean excludeNonExposedFields();
55 |
56 | abstract ImmutableList reflectAnnotations();
57 |
58 | abstract boolean allowSerializable();
59 |
60 | abstract boolean isLombokEnabled();
61 |
62 | static OptionsDescriptor create(
63 | AnnotationMirror mirror,
64 | ImmutableList> excludeModifiers,
65 | ImmutableList excludeAnnotationNames,
66 | ImmutableList exposeAnnotationNames,
67 | boolean excludeNonExposedFields,
68 | ImmutableList reflectAnnotations,
69 | boolean allowSerializable,
70 | boolean isLombokEnabled) {
71 | return new AutoValue_OptionsDescriptor(
72 | mirror,
73 | excludeModifiers,
74 | excludeAnnotationNames,
75 | exposeAnnotationNames,
76 | excludeNonExposedFields,
77 | reflectAnnotations,
78 | allowSerializable,
79 | isLombokEnabled);
80 | }
81 | }
82 |
--------------------------------------------------------------------------------
/examples/autovalue-example/src/main/java/nz/bradcampbell/autovalueexample/MainActivity.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package nz.bradcampbell.autovalueexample;
18 |
19 | import android.os.Bundle;
20 | import android.support.v7.app.AppCompatActivity;
21 | import android.support.v7.widget.Toolbar;
22 | import android.view.View;
23 | import android.widget.TextView;
24 |
25 | import java.text.DateFormat;
26 | import java.text.SimpleDateFormat;
27 | import java.util.Date;
28 | import java.util.Locale;
29 |
30 | import androidx.annotation.Nullable;
31 |
32 | public class MainActivity extends AppCompatActivity {
33 | private static final String STATE_KEY = "state";
34 |
35 | private State state = State.create(0, new Date());
36 | private DateFormat dateFormat = new SimpleDateFormat("HH:mm", Locale.getDefault());
37 |
38 | @Override protected void onCreate(@Nullable Bundle savedInstanceState) {
39 | super.onCreate(savedInstanceState);
40 | setContentView(R.layout.activity_main);
41 |
42 | if (savedInstanceState != null) {
43 | state = savedInstanceState.getParcelable(STATE_KEY);
44 | }
45 |
46 | Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
47 | setSupportActionBar(toolbar);
48 |
49 | View plusButton = findViewById(R.id.add_button);
50 | plusButton.setOnClickListener(new View.OnClickListener() {
51 | @Override public void onClick(View v) {
52 | state = State.create(state.count() + 1, new Date());
53 | updateText();
54 | }
55 | });
56 |
57 | View subtractButton = findViewById(R.id.subtract_button);
58 | subtractButton.setOnClickListener(new View.OnClickListener() {
59 | @Override public void onClick(View v) {
60 | state = State.create(state.count() - 1, new Date());
61 | updateText();
62 | }
63 | });
64 |
65 | updateText();
66 | }
67 |
68 | private void updateText() {
69 | TextView counter = (TextView) findViewById(R.id.counter);
70 | counter.setText(
71 | state.count() + " (updated at " + dateFormat.format(state.modificationDate()) + ")");
72 | }
73 |
74 | @Override protected void onSaveInstanceState(Bundle outState) {
75 | super.onSaveInstanceState(outState);
76 | outState.putParcelable(STATE_KEY, state);
77 | }
78 | }
79 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/FieldDescriptor.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package paperparcel;
18 |
19 | import com.google.auto.common.MoreTypes;
20 | import com.google.auto.common.Visibility;
21 | import com.google.auto.value.AutoValue;
22 | import com.google.common.base.Equivalence;
23 | import javax.lang.model.element.TypeElement;
24 | import javax.lang.model.element.VariableElement;
25 | import javax.lang.model.type.DeclaredType;
26 | import javax.lang.model.type.TypeMirror;
27 | import javax.lang.model.util.Types;
28 |
29 | /** Represents a single field in a {@link PaperParcel} class */
30 | @AutoValue
31 | abstract class FieldDescriptor {
32 |
33 | /** The original {@link VariableElement} that this class is describing */
34 | abstract VariableElement element();
35 |
36 | /** The simple name of the field */
37 | abstract String name();
38 |
39 | /** The original type of the field */
40 | abstract Equivalence.Wrapper type();
41 |
42 | /** True if this field is not private */
43 | abstract boolean isVisible();
44 |
45 | /** True if the field is not annotated with {@code @NonNull} or {@code @NotNull}. */
46 | abstract boolean isNullable();
47 |
48 | static final class Factory {
49 | private static final String NON_NULL_ANNOTATION_NAME = "NonNull";
50 | private static final String NOT_NULL_ANNOTATION_NAME = "NotNull";
51 |
52 | private final Types types;
53 |
54 | Factory(
55 | Types types) {
56 | this.types = types;
57 | }
58 |
59 | FieldDescriptor create(TypeElement owner, VariableElement element) {
60 | String name = element.getSimpleName().toString();
61 | TypeMirror type = types.asMemberOf((DeclaredType) owner.asType(), element);
62 | TypeMirror fieldType = Utils.replaceTypeVariablesWithUpperBounds(types, type);
63 | Equivalence.Wrapper wrappedType = MoreTypes.equivalence().wrap(fieldType);
64 | boolean isVisible = Visibility.ofElement(element) != Visibility.PRIVATE;
65 | boolean isNullable =
66 | Utils.getAnnotationWithSimpleName(element, NON_NULL_ANNOTATION_NAME) == null
67 | && Utils.getAnnotationWithSimpleName(element, NOT_NULL_ANNOTATION_NAME) == null;
68 | return new AutoValue_FieldDescriptor(element, name, wrappedType, isVisible, isNullable);
69 | }
70 | }
71 | }
72 |
--------------------------------------------------------------------------------
/docs/2.x/paperparcel/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | Generated Documentation (Untitled)
7 |
59 |
60 |
71 |
72 |
--------------------------------------------------------------------------------
/docs/2.x/paperparcel-kotlin/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | Generated Documentation (Untitled)
8 |
60 |
61 |
72 |
73 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/PaperParcelAutoValueExtensionValidator.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package paperparcel;
18 |
19 | import com.google.auto.common.MoreElements;
20 | import com.google.auto.common.MoreTypes;
21 | import com.google.common.collect.ImmutableSet;
22 |
23 | import java.util.List;
24 |
25 | import javax.lang.model.element.ExecutableElement;
26 | import javax.lang.model.element.Modifier;
27 | import javax.lang.model.element.TypeElement;
28 | import javax.lang.model.element.VariableElement;
29 | import javax.lang.model.type.TypeMirror;
30 | import javax.lang.model.util.Elements;
31 | import javax.lang.model.util.Types;
32 |
33 | import androidx.annotation.Nullable;
34 |
35 | final class PaperParcelAutoValueExtensionValidator {
36 | private final Elements elements;
37 | private final Types types;
38 |
39 | PaperParcelAutoValueExtensionValidator(
40 | Elements elements,
41 | Types types) {
42 | this.elements = elements;
43 | this.types = types;
44 | }
45 |
46 | ValidationReport validate(TypeElement subject) {
47 | ValidationReport.Builder report = ValidationReport.about(subject);
48 | ExecutableElement writeToParcel = findWriteToParcel(subject);
49 | if (writeToParcel != null) {
50 | report.addError(String.format(
51 | ErrorMessages.MANUAL_IMPLEMENTATION_OF_WRITE_TO_PARCEL, subject.getQualifiedName()),
52 | writeToParcel);
53 | }
54 | VariableElement creator = Utils.findCreator(elements, types, subject);
55 | if (creator != null) {
56 | report.addError(String.format(
57 | ErrorMessages.MANUAL_IMPLEMENTATION_OF_CREATOR, subject.getQualifiedName()),
58 | creator);
59 | }
60 | return report.build();
61 | }
62 |
63 | @Nullable private ExecutableElement findWriteToParcel(TypeElement subject) {
64 | TypeMirror parcel = elements.getTypeElement("android.os.Parcel").asType();
65 | @SuppressWarnings("deprecation") // Support for kapt2
66 | ImmutableSet methods =
67 | MoreElements.getLocalAndInheritedMethods(subject, elements);
68 | for (ExecutableElement element : methods) {
69 | if (element.getSimpleName().contentEquals("writeToParcel")
70 | && MoreTypes.isTypeOf(void.class, element.getReturnType())
71 | && !element.getModifiers().contains(Modifier.ABSTRACT)) {
72 | List parameters = element.getParameters();
73 | if (parameters.size() == 2
74 | && types.isSameType(parcel, parameters.get(0).asType())
75 | && MoreTypes.isTypeOf(int.class, parameters.get(1).asType())) {
76 | return element;
77 | }
78 | }
79 | }
80 | return null;
81 | }
82 | }
83 |
--------------------------------------------------------------------------------
/paperparcel-compiler/src/main/java/paperparcel/PaperParcelProcessor.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright (C) 2016 Bradley Campbell.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | package paperparcel;
18 |
19 | import com.google.auto.common.BasicAnnotationProcessor;
20 | import com.google.auto.service.AutoService;
21 | import com.google.common.collect.ImmutableList;
22 | import com.google.googlejavaformat.java.filer.FormattingFiler;
23 |
24 | import net.ltgt.gradle.incap.IncrementalAnnotationProcessor;
25 | import net.ltgt.gradle.incap.IncrementalAnnotationProcessorType;
26 |
27 | import javax.annotation.processing.Filer;
28 | import javax.annotation.processing.Messager;
29 | import javax.annotation.processing.Processor;
30 | import javax.lang.model.SourceVersion;
31 | import javax.lang.model.util.Elements;
32 | import javax.lang.model.util.Types;
33 |
34 | /**
35 | * The annotation processor responsible for generating the classes that drive the PaperParcel
36 | * implementation.
37 | */
38 | @AutoService(Processor.class)
39 | @IncrementalAnnotationProcessor(IncrementalAnnotationProcessorType.AGGREGATING)
40 | public class PaperParcelProcessor extends BasicAnnotationProcessor {
41 | @Override public SourceVersion getSupportedSourceVersion() {
42 | return SourceVersion.latestSupported();
43 | }
44 |
45 | @Override protected Iterable initSteps() {
46 | Messager messager = processingEnv.getMessager();
47 | Types types = processingEnv.getTypeUtils();
48 | Elements elements = processingEnv.getElementUtils();
49 | Filer filer = new FormattingFiler(processingEnv.getFiler());
50 |
51 | AdapterRegistry adapterRegistry = new AdapterRegistry(elements, types);
52 | OptionsHolder optionsHolder = new OptionsHolder();
53 |
54 | AdapterValidator adapterValidator = new AdapterValidator(elements, types);
55 | PaperParcelValidator paperParcelValidator =
56 | new PaperParcelValidator(elements, types);
57 |
58 | FieldDescriptor.Factory fieldDescriptorFactory = new FieldDescriptor.Factory(types);
59 | AdapterDescriptor.Factory adapterFactory = new AdapterDescriptor.Factory(elements, types, adapterRegistry);
60 | PaperParcelDescriptor.Factory paperParcelDescriptorFactory =
61 | new PaperParcelDescriptor.Factory(
62 | elements,
63 | types,
64 | adapterFactory,
65 | fieldDescriptorFactory);
66 |
67 | PaperParcelGenerator paperParcelGenerator = new PaperParcelGenerator(filer);
68 |
69 | return ImmutableList.of(
70 | new OptionsProcessingStep(
71 | messager,
72 | optionsHolder),
73 | new AdapterProcessingStep(
74 | messager,
75 | adapterValidator,
76 | adapterRegistry),
77 | new PaperParcelProcessingStep(
78 | messager,
79 | optionsHolder,
80 | paperParcelValidator,
81 | paperParcelDescriptorFactory,
82 | paperParcelGenerator));
83 | }
84 | }
85 |
--------------------------------------------------------------------------------