ajc - Bulutta Çevrimiçi

Program:

ADI

ajc — AspectJ ve Java dilleri için derleyici ve bayt kodu dokumacısı

SİNOPSİS

ajc [Opsiyonlar] [dosya ... | @dosya ... | -arg dosyası dosya ... ]

Açıklama

The ajc komut, AspectJ ve Java kaynak ve .class dosyalarını derler ve örer,
Herhangi bir Java VM (1.1 veya üstü) ile uyumlu .class dosyaları. Derlemeyi birleştirir ve
bayt kodu dokuma ve artımlı yapıları destekler; ayrıca çalışma zamanında bayt kodunu da örebilirsiniz
kullanma "" >.

Seçeneklerden sonraki argümanlar, derlenecek kaynak dosya(lar)ı belirtir. Kaynak belirtmek için
sınıflar, kullanım -yolda (altında). Dosyalar doğrudan komut satırında veya bir
dosya. -arg dosyası dosya ve @dosya formlar eşdeğerdir ve anlam olarak yorumlanır
belirtilen dosyada listelenen tüm bağımsız değişkenler.

Not: Açıkça geçmelisiniz ajc gerekli tüm kaynaklar. Kaynak eklediğinizden emin olun
sadece yönler veya nokta atışı için değil, aynı zamanda etkilenen türler için de. Tümünü belirterek
kaynaklar gereklidir, çünkü javac'tan farklı olarak, ajc kaynak yolunu aramaz.
sınıflar. (Etkilenen türlerin gerekli olabileceğine ilişkin bir tartışma için bkz. The AspectJ'yi
Programlama Kılavuz, Uygulama Ek ../progguide/implementation.html) .

Kaynakları belirtmek için kaynak dosyaları argüman olarak listeleyebilir veya seçenekleri kullanabilirsiniz. -kaynak kökler
or -yolda. Herhangi bir tür için birden fazla kaynak varsa, sonuç ajc'den beri tanımsızdır.
hangi kaynağın doğru olduğunu belirlemenin hiçbir yolu yoktur. (Bu, en sık kullanıcılar
hedef dizini yola dahil edin ve yeniden oluşturun.)

Opsiyonlar
-injar Kavanoz Listesi
kullanımdan kaldırıldı: 1.2'den beri, dizinleri de alan -inpath kullanın.

-yolda Yol
Herhangi bir .class dosyasını kaynak bayt kodu olarak kabul edin Çıktı şunları içerecektir
sınıflar, muhtemelen uygulanabilir yönlerle dokunmuş olarak. Yol tektir
ile sınırlandırılmış, zip dosyalarına veya dizinlerine giden yolların bir listesini içeren argüman
platforma özel yol sınırlayıcı.

-görünüm yolu Yol
Tüm kaynaklara giden yoldaki jar dosyalarından ve dizinlerinden ikili özellikleri örün.
Yönler, derleyicinin aynı sürümü tarafından verilmiş olmalıdır. Ne zaman
çıktı sınıflarını çalıştırırken, çalıştırma sınıf yolu tüm en boy yollarını içermelidir
girdileri. Yol, sınıf yolu gibi, bir yol listesi içeren tek bir argümandır.
platforma özgü sınıf yolu sınırlayıcısı tarafından sınırlandırılan jar dosyalarına.

-arg dosyası fileto
Dosya, satırla ayrılmış bir argüman listesi içerir. Dosyadaki her satır
bir seçenek, dosya adı veya bağımsız değişken dizesi içermelidir (örneğin, bir sınıf yolu veya
yol). Dosyadan okunan argümanlar, argüman listesine eklenir.
komuta. Dosyadaki göreli yollar dizinden hesaplanır
dosyayı içeren (geçerli çalışma dizini değil). Yorumlar, Java'da olduğu gibi,
ile başla // ve satırın sonuna kadar uzatın. Bağımsız değişkende belirtilen seçenekler
dosyalar mevcut seçenek değerlerini genişletmek yerine geçersiz kılabilir, bu nedenle
gibi seçeneklerin belirtilmesi -sınıf yolu aksine argüman dosyalarında
argüman dosyası, tek derleme belirtimidir. form @dosya aynıdır
belirten -arg dosyası dosya.

-dış ses çıktı.jar
Çıktı sınıflarını zip dosyası output.jar'a koyun.

-outxml Varsayılan adla yükleme süresi dokuma için aop.xml dosyası oluşturun.

-outxml dosyası özel/aop.xml
Özel adla yükleme süresi dokuma için aop.xml dosyası oluşturun.

-artımlı
Derleyiciyi sürekli çalıştırın. İlk derlemeden sonra derleyici
standart girdiden yeni bir satır okuyana kadar yeniden derlemeyi bekleyin ve
bir 'q' okuduğunda çıkın. Yalnızca gerekli bileşenleri yeniden derleyecektir, bu nedenle
yeniden derleme, ikinci bir derleme yapmaktan çok daha hızlı olmalıdır. Bu gerektirir
-kaynak kökler.

-kaynak kökler DirPath'ler
Tüm .java veya .aj kaynak dosyalarını şurada listelenen herhangi bir dizinde bulun ve oluşturun
DirPath'ler. DirPath'ler, sınıf yolu gibi, aşağıdakilerin bir listesini içeren tek bir argümandır.
platforma özgü sınıf yolu sınırlayıcısı tarafından sınırlandırılan dizinlere giden yollar.
-artımlı tarafından gerekli.

-çapraz referanslar
Çıktı dizinine bir yapı .ajsym dosyası oluşturun. Görüntülemek için kullanılır
AspectJ Tarayıcı gibi araçlarla kesişen referanslar.

-emacssym emacs desteği için .ajesym sembol dosyaları oluşturun (kullanımdan kaldırıldı).

-Xlint -Xlint ile aynı:uyarı (varsayılan olarak etkindir)

-Xlint:{seviye}
Olası programlama hatalarıyla ilgili mesajlar için varsayılan seviyeyi ayarlayın.
kesişen kod. {level} yoksayma, uyarı veya hata olabilir. Bu geçersiz kılar
org/aspectj/weaver/XlintDefault.properties içindeki girdiler, enspectjtools.jar'dan, ancak
-Xlintfile seçeneği kullanılarak ayarlanan seviyeleri geçersiz kılmaz.

-Xlint dosyası Mülk Dosyası
Belirli kesişen mesajlar için seviyeleri ayarlamak için özellikler dosyasını belirtin.
PropertyFile, aynı özelliği alan bir Java .properties dosyasına giden yoldur
org/aspectj/weaver/XlintDefault.properties olarak adlar ve değerler
Aynı zamanda geçersiz kıldığı featurejtools.jar.

-help Derleyici seçenekleri ve kullanımı hakkında bilgi yayar

-version AspectJ derleyicisinin sürümünü yayar

-sınıf yolu Yol
Kullanıcı sınıfı dosyalarının nerede bulunacağını belirtin. Yol, bir
platforma özel olarak sınırlandırılmış, zip dosyalarına veya dizinlere giden yolların listesi
yol sınırlayıcı.

-önyükleme sınıfı yolu Yol
Şu durumlarda türleri değerlendirmek amacıyla VM'nin önyükleme sınıfı yolunun konumunu geçersiz kılın.
derleme. Yol, zip dosyalarına veya zip dosyalarına giden yolların listesini içeren tek bir argümandır.
platforma özgü yol sınırlayıcı tarafından sınırlandırılan dizinler.

-extdirs Yol
Türleri değerlendirmek amacıyla VM'nin uzantı dizinlerinin konumunu geçersiz kıl
derleme yaparken. Yol, yolların bir listesini içeren tek bir argümandır.
platforma özgü yol sınırlayıcı tarafından sınırlandırılan dizinler.

-d rehber
Oluşturulan .class dosyalarının nereye yerleştirileceğini belirtin. Belirtilmemişse, rehber
geçerli çalışma dizini için varsayılandır.

-hedef [1.1 için 1.5]
Sınıf dosyası hedef ayarını belirtin (1.1 - 1.5, varsayılan 1.2'dir)

-1.3 Uyumluluk düzeyini 1.3 olarak ayarlayın Bu, -source 1.3 ve -hedef 1.1 anlamına gelir.

-1.4 Uyumluluk düzeyini 1.4'e ayarlayın (varsayılan) Bu, -source 1.4 ve -target 1.2 anlamına gelir.

-1.5 Uyumluluk seviyesini 1.5 olarak ayarlayın. Bu, -source 1.5 ve -target 1.5 anlamına gelir.

-kaynak [1.3|1.4|1.5]
Onayları aç/kapat (1.3, 1.4 veya 1.5 - varsayılan değer 1.4'tür). -source 1.3 kullanırken,
Java 1.4 altında geçerli olan bir assert() ifadesi bir derleyici hatasına neden olur.
-source 1.4 kullanırken, tedavi edin ileri sürmek anahtar kelime olarak ve iddiaları uygulayın
1.4 dil spesifikasyonuna göre. -source 1.5, Java 5 dili kullanılırken
özelliklere izin verilir.

-nowarn Uyarı yaymaz ('-warn:none' ile eşdeğerdir) Bu, mesajları bastırmaz
tarafından oluşturuldu bildirmek uyarı or Xlint.

-uyarmak: ürün
Virgülle ayrılmış şüpheli kod listesinin herhangi bir örneği için uyarı yayınlayın
(örneğin '-warn:unusedLocals, kullanımdan kaldırma'):

yapıcı adı ile yapıcıAdı yöntemi
packageDefaultMethod, varsayılan paket yöntemini geçersiz kılmaya çalışıyor
kullanımdan kaldırılmış tür veya üyenin kullanımdan kaldırılması
maskedCatchBlocks gizli yakalama bloğu
unusedLocals yerel değişkeni asla okumaz
unsedArguments yöntem argümanı asla okunmaz
unusedImports import ifadesi dosyadaki kod tarafından kullanılmıyor
hiçbiri tüm derleyici uyarılarını bastırmaz

-uyar: yok tarafından oluşturulan mesajları bastırmaz bildirmek uyarı or Xlint.

-kullanımdan kaldırma
-warn:deprecation ile aynı

-noImportError
Çözümlenmemiş içe aktarmalar için hata yayma

-proceedOnError
Hatadan sonra derlemeye devam edin, sınıf dosyalarını sorunlu yöntemlerle boşaltın

-g:[satırlar,değişkenler,kaynak]
üç biçimde olabilen hata ayıklama öznitelikleri düzeyi:

-g tüm hata ayıklama bilgileri ('-g:lines,vars,source')
-g: yok hata ayıklama bilgisi yok
-g:{items} [lines, vars, source] öğelerinin herhangi biri/tümü için hata ayıklama bilgisi, ör.
-g: çizgiler, kaynak

-TümYerelleri koru
Kod oluşturma sırasında tüm yerel değişkenleri koruyun (hata ayıklamayı kolaylaştırmak için).

-referansBilgisi
Referans bilgilerini hesaplayın.

-kodlama biçim
Varsayılan kaynak kodlama biçimini belirtin. Dosya başına özel kodlamayı belirtin
her bir girdi kaynağı dosya/klasör adının sonuna '[kodlama]' ekleyerek temel alın.

-verbose Erişilen/işlenen derleme birimleri hakkında mesajlar yayar

-showWeaveInfo
Dokuma hakkında mesajlar yayar

log dosya Derleyici mesajları için bir günlük dosyası belirtin.

-progress İlerlemeyi göster (-log modu gerektirir).

-zaman Hız bilgilerini görüntüler.

-noExit Derlemenin sonunda System.exit(n)'yi çağırmayın (hata yoksa n=0)

-tekrarlamak N Derleme işlemini N kez tekrarlayın (genellikle performans analizi yapmak için).

-XterminateAfterDerleme
Derleyicinin dokumadan önce sonlandırılmasına neden olur

-XaddSerialVersionUID
Derleyicinin SerialVersionUID alanını hesaplamasına ve herhangi bir türe eklemesine neden olur
bir açıdan etkilenen Serializable'ı uygulamak. alan
dokuma yapılmadan önceki sınıfa göre hesaplanmıştır.

-Xreweavable[:sıkıştır]
(Deneysel - artık varsayılan olarak kullanımdan kaldırılmıştır) Dokumacıyı yeniden dokunabilir modda çalıştırır.
bağlı olarak yeniden dokunabilen dokuma sınıflar yaratmasına neden olur.
dokumayı tavsiye eden tüm türleri yeniden dokumaya teşebbüs etme kısıtlaması
türü erişilebilir olmalıdır.

-XnoInline
(Deneysel) tavsiye etrafında satır içi yapmayın

-XincrementalDosya dosya
(Deneysel) Bu, artımlı mod gibi çalışır, ancak
derleyiciyi kontrol etmek için standart girdi. Dosya her açıldığında yeniden derlenir.
değişti ve dosya silindiğinde durur.

-XserializableAspects
(Deneysel) Normalde, özellikleri Serileştirilebilir olarak bildirmek bir hatadır. Bu
seçeneği bu kısıtlamayı kaldırır.

-XnotYeniden Dokunabilir
(Deneysel) AspectJ tarafından sonradan yeniden dokunulamayan sınıf dosyaları oluşturun.

-Xajruntimeseviyesi:1.2, ajruntimeseviyesi:1.5
(Deneysel) 1.2 veya 1.5 seviyesini hedefleyen kodun oluşturulmasına izin verir
AspectJ çalışma zamanı (varsayılan 1.5)

fileto isimleri
ajc, kaynak dosyaları aşağıdakilerden biriyle kabul eder: .Java uzatma veya .aj eklenti. Biz
normalde kullan .Java bir AspectJ sistemindeki tüm dosyalarımız için -- yönleri içeren dosyalar
yanı sıra sınıfları içeren dosyalar. Ancak, mekanik olarak bir ihtiyacınız varsa
AspectJ'nin ek işlevlerini kullanan dosyaları saf olanlardan ayırt eder
Java'yı kullanmanızı öneririz .aj Bu dosyalar için uzantı.

Adlandırma kuralları gibi diğer mekanik ayrım araçlarından vazgeçmek istiyoruz
veya alt paketler lehine .aj eklenti.

· Dosya adı kurallarının uygulanması zordur ve özellikleriniz için uygunsuz adlara yol açar.
Yerine TracingAspect.java kullanmanızı öneririz izleme.aj (ya da sadece izleme.java)
yerine.

· Alt paketler, unsurları bir sistemdeki doğal yerlerinin dışına taşır ve
ayrıcalıklı yönler için yapay ihtiyaç. Gibi bir alt paket eklemek yerine
yönleri kullanmanızı öneririz .aj uzantılı ve bu dosyaları
bunun yerine mevcut paketler.

uygunluk
AspectJ, Java programlama dilinin uyumlu bir uzantısıdır. AspectJ derleyicisi
yapışır The Java Dil Özellikler, İkinci baskı (KİTAP)
http://java.sun.com/docs/books/jls/index.html ve The Java Sanal makine
Şartname, İkinci baskı (KİTAP) http://java.sun.com/docs/books/vmspec/index.html ve
Java 2 uyumlu herhangi bir platformda çalışır. Oluşturduğu kod herhangi bir Java 1.1 veya
daha sonra uyumlu platform. Java ve ile uyumluluk hakkında daha fazla bilgi için
AspectJ'nin önceki sürümleri, bkz. "" >.

Örnekler
A basit örnek

İki dosyayı derleyin:

ajc HelloWorld.java Trace.java

An örnek kullanma -argdosyası/@

Dosya adlarını komut satırında belirtmekten kaçınmak için kaynak dosyaları satırla ayrılmış bir şekilde listeleyin.
metin arg dosyası. Kaynak dosya yolları, mutlak veya arg dosyasına göreli olabilir ve
@-referansına göre diğer argüman dosyalarını dahil edin. Aşağıdaki dosya kaynaklar.lst içeren
mutlak ve göreli dosyalar ve @ referansları:

gui.java
/home/user/src/Library.java
veri/Repository.java
veri/Access.java
@../../common/common.lst
@/home/user/src/lib.lst
görünüm/gövde/ArrayView.java

-argfile veya @ formunu kullanarak dosyaları derleyin:

ajc -argfile kaynakları.lst
ajc @kaynaklar.lst

Arg dosyaları ayrıca jikes ve javac tarafından da desteklenir, böylece dosyaları hibrit yapılarda kullanabilirsiniz.
Ancak, destek değişir:

· Yalnızca ajc komut satırı seçeneklerini kabul eder

· Jikes ve Javac, dahili @argfile referanslarını kabul etmez.

· Jikes ve Javac, yalnızca komut satırında @file formunu kabul eder.

An örnek kullanma -yolda ve -görünüm yolu

-inpath kullanarak bayt kodu dokuma: AspectJ 1.2, zip/jar girişinde .class dosyalarını dokumayı destekler
dosyalar ve dizinler. Girdi kavanozlarını kullanmak, karşılık gelen kaynak dosyalarını derlemek gibidir,
ve tüm ikili dosyalar çıktıya gönderilir. Java uyumlu derleyiciler farklılık gösterse de
çıktıları, ajc, javac, jikes, eclipse tarafından üretilen herhangi bir sınıf dosyasını girdi olarak almalıdır,
ve tabii ki, ajc. -inpath'a dahil olan yönler, diğer .class gibi dokunacaktır.
dosyalar ve diğer türleri her zamanki gibi etkilerler.

-aspectpath kullanan en boy kitaplıkları: AspectJ 1.1, salt okunur kitaplıklardan dokumayı destekler
yönleri içeren. Girdi kavanozları gibi, tüm girdileri etkilerler; giriş kavanozlarından farklı olarak,
kendileri etkilenmez veya çıktı olarak yayılmaz. En boy kitaplıklarıyla derlenen kaynaklar
sınıf yollarında aynı en boy kitaplıklarıyla çalıştırılmalıdır.

Aşağıdaki örnek, izleme örneğini bir komut satırı ortamında oluşturur; yaratır
salt okunur bir görünüm kitaplığı, giriş bayt kodu olarak kullanılmak üzere bazı sınıfları derler ve derler
görünüm kütüphanesi ile sınıflar ve diğer kaynaklar.

İzleme örneği, AspectJ dağılımındadır ({aspectj}/doc/examples/tracing). Bu
aşağıdaki dosyaları kullanır:

en boyj1.1/
çöp Kutusu/
ajc
lib /
boyjrt.jar
örnekler/
izleme/
Çember.java
ÖrnekMain.java
lib /
Soyutizleme.java
TraceMyClasses.java
notrace.lst
kare.java
tracelib.lst
tracev3.lst
TwoDSShape.java
sürüm3/
Trace.java
TraceMyClasses.java

Aşağıda, yol ayırıcı ";" olarak alınır, ancak dosya ayırıcılar "/" şeklindedir. Tüm komutlar
bir satırda. Yolları ve komutları ortamınıza göre gerektiği gibi ayarlayın.

Yolu, sınıf yolunu ve geçerli dizini ayarlayın:

cd örnekleri
dışa aktar ajrt=../lib/aspectjrt.jar
CLASSPATH = "$ajrt" dışa aktar
PATH'yi dışa aktar = "../çöp Kutusu:$YOL"

Salt okunur bir izleme kitaplığı oluşturun:

ajc -argfile izleme/tracelib.lst -outjar tracelib.jar

Uygulamayı tek adımda izleme ile oluşturun:

ajc -aspectpath tracelib.jar -argfile izleme/notrace.lst -outjar tracedapp.jar

Uygulamayı izleme ile çalıştırın:

Java -classpath "$ajrt;tracedapp.jar;tracelib.jar" izleme.ÖrnekAna

Uygulamayı iki adımda ikili dosyalardan izleme ile oluşturun:

· (a) Uygulama sınıflarını oluşturun (göstermek için javac kullanarak):

mkdir sınıfları
javac -d sınıfları izleme/*.java
jar cfM app.jar -C sınıfları .

· (b) Uygulamayı izleme ile oluşturun:

ajc -inpath uygulaması.jar -aspectpath tracelib.jar -outjar tracedapp.jar

Uygulamayı izleme ile çalıştırın (yukarıdakiyle aynı):

Java -classpath "$ajrt;tracedapp.jar;tracelib.jar" izleme.ÖrnekAna

Uygulamayı izlemeden çalıştırın:

java -classpath "app.jar" izleme.ÖrnekAna

The AspectJ'yi derleyici API
AspectJ derleyicisi tamamen Java'da uygulanır ve bir Java sınıfı olarak adlandırılabilir.
Genel olarak kabul edilmesi gereken tek arayüz, genel yöntemlerdir.
org.aspectj.tools.ajc.Ana. Örneğin, main(Dize[] argümanlar) standardı alır ajc komuta
satır argümanları. Bu, derleyiciyi çalıştırmanın alternatif bir yolunun

Java org.aspectj.tools.ajc.Ana [seçenek...] [dosya ...]

Derleyici mesajlarına programlı olarak erişmek için yöntemleri kullanın. setHolder(IMessageHolder
Kulp) ve / veya çalıştır(Dize[] argümanlar, IMessageHolder Kulp). ajc her mesajı rapor eder
tutucu kullanarak IMessageHolder.handleMessage(..). Sadece mesajları toplamak istiyorsanız,
kullanım Mesaj İşleyici seninki IMessageHolder. Örneğin, derleyin ve çalıştırın
ile takip görünümjtools.jar sınıf yolunda:

org.aspectj.bridge.* dosyasını içe aktarın;
org.aspectj.tools.ajc.Main'i içe aktarın;
java.util.Arrays'i içe aktarın;

genel sınıf WrapAjc {
public static void main (String [] args) {
Ana derleyici = new Main();
MessageHandler m = yeni MessageHandler();
derleyici.run(args, m);
IMessage[] ms = m.getMessages(null, true);
System.out.println("mesajlar:" + Diziler.asList(Hanım));
}
}

Yığın İzler ve the Kaynak dosyası nitelik
Geleneksel java derleyicilerinden farklı olarak, AspectJ derleyicisi belirli durumlarda
birden çok kaynak dosyadan sınıf dosyaları. Ne yazık ki, orijinal Java sınıfı dosya biçimi
birden çok SourceFile özniteliğini desteklemez. Tüm kaynak dosyadan emin olmak için
bilgi mevcutsa, AspectJ derleyicisi bazı durumlarda birden çok dosya adını kodlayabilir
SourceFile özniteliğinde. Java VM yığın izleri oluşturduğunda bunu kullanır.
kaynak dosyayı belirtmek için öznitelik.

(AspectJ 1.0 derleyicisi ayrıca JSR-45'in .class dosya uzantılarını da destekler. Bunlar
uyumlu hata ayıklayıcıların (Java 1.4.1'deki jdb gibi) doğru dosya ve satırı tanımlamasına izin verir
hatta tek bir sınıf için birçok kaynak dosya verildi. ajc için JSR-45 desteği planlanıyor
AspectJ 1.1, ancak ilk sürümde değil. Tamamen hata ayıklanabilir .class dosyaları elde etmek için şunu kullanın:
-XnoInline seçeneği.)

Muhtemelen bu formatı görebileceğiniz tek zaman yığın izlerini görüntülediğiniz zamandır.
biçimin izleriyle karşılaşabilir

java.lang.NullPointerException
Main.new$constructor_call37(Main.java;SynchAspect.java[1k]:1030) adresinde

her zamanki yerine nerede

Dosya:Satır Numarası

biçim, görüyorsun

File0;File1[Number1];File2[Number2] ... :LineNumber

Bu durumda, LineNumber, satırlardaki olağan ofset artı gerçek satırın "başlangıç ​​satırı"dır.
Kaynak dosyası. Bu, hem kaynak dosyayı tanımlamak hem de bulmak için LineNumber'ı kullandığınız anlamına gelir.
söz konusu hat. Her dosyadan sonra [parantez] içindeki sayı size sanal "başla
satırı" bu dosya için (ilk dosyanın başlangıcı 0'dır).

Boş gösterici istisna izindeki örneğimizde, sanal başlangıç ​​çizgisi 1030'dur.
SynchAspect.java dosyası 1000 [1k] satırında "başladığından", LineNumber satırı işaret eder
30 SynchAspect.java.

Bu nedenle, bu tür yığın izleriyle karşılaştığınızda, gerçek kaynak konumunu bulmanın yolu,
gösterilen satırın hemen altındakini bulmak için "başlangıç ​​satırı" numaraları listesine bakın
numara. Bu, kaynak konumun gerçekten bulunabileceği dosyadır. sonra, çıkar
içindeki gerçek satır numarasını bulmak için gösterilen satır numarasından "başlangıç ​​satırı"
dosyası.

Yalnızca tek bir kaynak dosyadan gelen bir sınıf dosyasında, AspectJ derleyicisi
Geleneksel Java derleyicileriyle tutarlı SourceFile öznitelikleri.

ajc(1)

onworks.net hizmetlerini kullanarak ajc'yi çevrimiçi kullanın