Why you're missing out if you're not making Quarkus extensions

Holly Cummins @holly_cummins Georgios Andrianakis @geoand86 Red Hat Why you're
missing out if you're not making Quarkus extensions

@holly_cummins @geoand86 #Quarkus #RedHat Hi Georgios!

@holly_cummins @geoand86 #Quarkus #RedHat extenwhats?

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus core

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus core JAX-RS

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus core Hibernate JAX-RS

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus core Hibernate JAX-RS Netty

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus core Hibernate JAX-RS Netty JWT

Elasticsearch

Elasticsearch Apache Camel

gRPC Elasticsearch Apache Camel

gRPC Elasticsearch Apache Camel …

gRPC Elasticsearch Netty extension Apache Camel …

gRPC Elasticsearch Netty extension JAX-RS extension Apache Camel …

gRPC Elasticsearch Netty extension JAX-RS extension Elasticsearch extension Apache Camel …

gRPC Elasticsearch Netty extension JAX-RS extension Elasticsearch extension Hibernate extension Apache Camel …

gRPC Elasticsearch Netty extension JAX-RS extension Elasticsearch extension Hibernate extension Apache Camel Camel extension …

gRPC Elasticsearch JWT extension Netty extension JAX-RS extension Elasticsearch extension Hibernate extension Apache Camel Camel extension …

gRPC Elasticsearch gRPC extension JWT extension Netty extension JAX-RS extension Elasticsearch extension Hibernate extension Apache Camel Camel extension …

gRPC Elasticsearch gRPC extension JWT extension Netty extension JAX-RS extension Elasticsearch extension Hibernate extension lots more extensions Apache Camel Camel extension …

gRPC Elasticsearch gRPC extension JWT extension Netty extension JAX-RS extension Elasticsearch extension Hibernate extension lots more extensions Apache Camel Camel extension … quarkiverse

@holly_cummins @geoand86 #Quarkus #RedHat why?

@holly_cummins @geoand86 #Quarkus #RedHat reminder: what makes quarkus special

traditional way vs quarkus way @   @ </> build
time runtime

@   @ </> traditional way vs quarkus way @
  @ </> build time runtime build time

@   @ </> traditional way vs quarkus way @
  @ </> build time runtime runtime build time

the quarkus way enables native compilation native @   @
</> JVM build time

9 but … for a normal framework …

9 they load way too many classes but … for
a normal framework …

9 they load way too many classes they are way
too dynamic but … for a normal framework …

too dynamic (which means they use way too much reflection) but … for a normal framework …

too dynamic (which means they use way too much reflection) they perform a lot of initialization at runtime but … for a normal framework …

@   @ </> Packaging   (maven, gradle…) build time
runtime how does a framework start?

@   @ </> Load and parse config files, properties,
yaml, xml, etc. build time runtime how does a framework start?

@   @ </> Classpath scanning and annotation discovery Attempt
to load class to enable/disable features build time runtime how does a framework start?

@   @ </> Build its metamodel of the world.
build time runtime how does a framework start?

@   @ </> Start thread pools, IO, etc. build
time runtime how does a framework start?

Do the work once, not at each start Get rid
of all bootstrap classes Less time to start, less memory needed Less or no reflection nor dynamic proxies what if we initialize at build time?

@   @ </> build time Do the work once,
not at each start Get rid of all bootstrap classes Less time to start, less memory needed Less or no reflection nor dynamic proxies what if we initialize at build time?

@   @ </> runtime build time Do the work
once, not at each start Get rid of all bootstrap classes Less time to start, less memory needed Less or no reflection nor dynamic proxies what if we initialize at build time?

and another thing

and another thing developer experience

and another thing developer experience developer joy

“while we’re manipulating the bytecode to support native, why don’t
we make coding … easier?” [warning: may not actually be Quarkus origin story]

automagic dev instances (“dev services”) unified config opinionated shortcuts joy
comes in several forms:

@holly_cummins @geoand86 #Quarkus #RedHat <persistence xmlns="https://jakarta.ee/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance" version="3.0" xsi:schemalocation="https://jakarta.ee/xml/ns/
persistence https://jakarta.ee/xml/ns/persistence/ persistence_3_0.xsd">  <persistence-unit name="my-persistence-unit"> </persistence-unit> </persistence> persistence.xml hibernate extension

@holly_cummins @geoand86 #Quarkus #RedHat <persistence xmlns="https://jakarta.ee/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance" version="3.0" xsi:schemalocation="https://jakarta.ee/xml/ns/
persistence https://jakarta.ee/xml/ns/persistence/ persistence_3_0.xsd">  <persistence-unit name="my-persistence-unit"> </persistence-unit> </persistence> persistence.xml hibernate extension the hibernate extension makes this go away

@holly_cummins @geoand86 #Quarkus #RedHat

@holly_cummins @geoand86 #Quarkus #RedHat dynamic-but-static

@holly_cummins @geoand86 #Quarkus #RedHat dynamic-but-static “wouldn’t it be nice if
…   … but it’s too expensive to do it at runtime.”

@holly_cummins @geoand86 #Quarkus #RedHat public class CassandraConnector { private Cluster
cluster; private Session session; public void connect(String node, Integer port) { Builder b = Cluster.builder().addContactPoint(node); if (port != null) { b.withPort(port); } cluster = b.build(); session = cluster.connect(); } public Session getSession() { return this.session; } public void close() { session.close(); cluster.close(); } }

@holly_cummins @geoand86 #Quarkus #RedHat public class CassandraConnector { private Cluster
cluster; private Session session; public void connect(String node, Integer port) { Builder b = Cluster.builder().addContactPoint(node); if (port != null) { b.withPort(port); } cluster = b.build(); session = cluster.connect(); } public Session getSession() { return this.session; } public void close() { session.close(); cluster.close(); } } @Inject private QuarkusCqlSession session;

@holly_cummins @geoand86 #Quarkus #RedHat “opinionated choices and educated guesses.”

@holly_cummins @geoand86 #Quarkus #RedHat recap: why extensions? • good behaviour
in native mode • fast behaviour in normal mode (pre-do all the things) • good dev experience

@geoand86 @holly_cummins #Quarkus #RedHat

@holly_cummins @geoand86 #Quarkus #RedHat why write a new extension? •
the community hasn’t written one yet • it’s your library • support a use case particular to your environment

@holly_cummins @geoand86 #Quarkus #RedHat “hook a build step?”

@holly_cummins @geoand86 #Quarkus #RedHat how?

@holly_cummins @geoand86 #Quarkus #RedHat extension concept deployment + runtime

@holly_cummins @geoand86 #Quarkus #RedHat extension concept build phase + startup
phase

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime bytecode

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime bytecode extension

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime bytecode extension deployment

runtime

runtime bytecode

@holly_cummins @geoand86 #Quarkus #RedHat deployment

@holly_cummins @geoand86 #Quarkus #RedHat understand app deployment

@holly_cummins @geoand86 #Quarkus #RedHat understand app convert annotations to bytecode
deployment

@holly_cummins @geoand86 #Quarkus #RedHat understand app convert annotations to bytecode
optimize deployment

@holly_cummins @geoand86 #Quarkus #RedHat extension concept build steps + build
items

@holly_cummins @geoand86 #Quarkus #RedHat build steps

@holly_cummins @geoand86 #Quarkus #RedHat build items

@holly_cummins @geoand86 #Quarkus #RedHat framework automatically determines correct execution order
and injects parameters

@holly_cummins @geoand86 #Quarkus #RedHat build items are communication mechanism between
build steps framework automatically determines correct execution order and injects parameters

@holly_cummins @geoand86 #Quarkus #RedHat initial state build items intermediate state
build items terminal state build items

@holly_cummins @geoand86 #Quarkus #RedHat initial state build items JarResultBuildStep intermediate
state build items terminal state build items

@holly_cummins @geoand86 #Quarkus #RedHat initial state build items JarResultBuildStep GeneratedResourceBuildItem
intermediate state build items terminal state build items

ConfigClassBuildItem intermediate state build items terminal state build items

ConfigClassBuildItem UnremovableBeanBuildItem intermediate state build items terminal state build items

ConfigClassBuildItem UnremovableBeanBuildItem BuildSystemTargetBuildItem intermediate state build items terminal state build items

ConfigClassBuildItem UnremovableBeanBuildItem BuildSystemTargetBuildItem LaunchModeBuildItem intermediate state build items terminal state build items

ConfigClassBuildItem UnremovableBeanBuildItem BuildSystemTargetBuildItem LaunchModeBuildItem most extensions do stuff here intermediate state build items terminal state build items

@holly_cummins @geoand86 #Quarkus #RedHat what kind of things can build
items do? Create a servlet Create a route Pull an external bean into the closed world Turn one annotation into another Add a log handler Read an extra application archive Flag a capability as present Interact with Kubernetes …

@holly_cummins @geoand86 #Quarkus #RedHat existing build items cover almost all
needs like a library for extension writers

@holly_cummins @geoand86 #Quarkus #RedHat extension concept index

@holly_cummins @geoand86 #Quarkus #RedHat extension concept index eliminates need for
runtime classpath scanning

@holly_cummins @geoand86 #Quarkus #RedHat extension concept index “jandex” eliminates need
for runtime classpath scanning

@holly_cummins @geoand86 #Quarkus #RedHat open world closed world

@holly_cummins @geoand86 #Quarkus #RedHat open world closed world hard to
build-time optimise

build-time optimise easy to build-time optimise

build-time optimise easy to build-time optimise runtime class surprise!

build-time optimise easy to build-time optimise no worries runtime class surprise!

build-time optimise easy to build-time optimise uh oh, this is outside our closed world no worries runtime class surprise!

@holly_cummins @geoand86 #Quarkus #RedHat AdditionalBeanBuildItem

@holly_cummins @geoand86 #Quarkus #RedHat extension concept bytecode recording easier than
writing ASM (if recording isn’t optimised enough, use Gizmo to hand-craft bytecode)

Example @Recorder public class CaffeineCacheBuildRecorder { // a proxy of
this is invoked at build time // the “real” invocation happens at runtime with the CaffeineCacheInfo obtained at build time public Supplier<CacheManager> getCacheManagerSupplier(Set<CaffeineCacheInfo> cacheInfos) { return new Supplier<CacheManager>() { @Override public CacheManager get() { if (cacheInfos.isEmpty()) { return new CacheManagerImpl(Collections.emptyMap()); } else { Map<String, Cache> caches = new HashMap<>(cacheInfos.size() + 1, 1.0F); for (CaffeineCacheInfo cacheInfo : cacheInfos) { CaffeineCache cache = new CaffeineCache(cacheInfo); caches.put(cacheInfo.name, cache); } return new CacheManagerImpl(caches); } } }; } }

@holly_cummins @geoand86 #Quarkus #RedHat extension concept configuration

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime extension

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime extension deployment

@holly_cummins @geoand86 #Quarkus #RedHat Quarkus deployment runtime extension deployment runtime

config config

config config config config

@holly_cummins @geoand86 #Quarkus #RedHat demo

@holly_cummins @geoand86 #Quarkus #RedHat demo: recap

@holly_cummins @geoand86 #Quarkus #RedHat https://github.com/holly-cummins/quarkus-minecraft-observability-extension

@holly_cummins @geoand86 #Quarkus #RedHat https://github.com/holly-cummins/ quarkus-minecraft-observability-extension

@holly_cummins @geoand86 #Quarkus #RedHat extension concept GraalVM • Contribute GraalVM
configuration ◦ Reflection registration ◦ Dynamic proxy registration ◦ Resource files ◦ Message bundles ◦ Etc.   • Provide substitutions ◦ Pieces of code that are used in place of regular library code when in native mode

Substitutions @TargetClass(org.infinispan.client.hotrod.impl.RemoteCacheImpl.class) public final class SubstituteRemoteCacheImpl { @Delete private ObjectName
mbeanObjectName; @Substitute private void registerMBean(ObjectName jmxParent) { } @Substitute private void unregisterMBean() { } @Delete public void init(OperationsFactory operationsFactory, Configuration configuration, ObjectName jmxParent) { } }

Real world examples • Jackson extension   • Hibernate Validator
extension   • Spring DI extension     Resources • http:/ /quarkus.io • https:/ /quarkus.io/guides/all-builditems • https:/ /quarkus.io/blog/quarkus-aws-cloudwatch_extension/ • https:/ /quarkus.io/blog/solving-problems-with-custom-extensions/

® thank you @holly_cummins @geoand86 https://github.com/holly- cummins/quarkus-minecraft- observability-extension code

Why you're missing out if you're not making Quarkus extensions

Why you're missing out if you're not making Quarkus extensions

More Decks by Holly Cummins

Other Decks in Programming

Featured

Transcript